Está en la página 1de 155

Informatica Data Quality (Version 9.5.

1)

Installation and Configuration Guide

Informatica Data Quality Installation and Configuration Guide


Version 9.5.1
December 2012
Copyright (c) 1998-2012 Informatica. All rights reserved.
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. This Software may be protected by U.S. and/or international
Patents and other Patents Pending.
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(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 product or documentation is subject to change without notice. If you find any problems in this product or documentation, please report them to us in
writing.
Informatica, Informatica Platform, Informatica Data Services, PowerCenter, PowerCenterRT, PowerCenter Connect, PowerCenter Data Analyzer, PowerExchange,
PowerMart, Metadata Manager, Informatica Data Quality, Informatica Data Explorer, Informatica B2B Data Transformation, Informatica B2B Data Exchange Informatica On
Demand, Informatica Identity Resolution, Informatica Application Information Lifecycle Management, Informatica Complex Event Processing, Ultra Messaging and Informatica
Master Data Management 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. All rights
reserved. Copyright Sun Microsystems. All rights reserved. Copyright RSA Security Inc. All Rights Reserved. Copyright Ordinal Technology Corp. All rights
reserved.Copyright Aandacht c.v. All rights reserved. Copyright Genivia, Inc. All rights reserved. Copyright Isomorphic Software. All rights reserved. Copyright Meta
Integration Technology, Inc. All rights reserved. Copyright Intalio. All rights reserved. Copyright Oracle. All rights reserved. Copyright Adobe Systems Incorporated. All
rights reserved. Copyright DataArt, Inc. All rights reserved. Copyright ComponentSource. All rights reserved. Copyright Microsoft Corporation. All rights reserved.
Copyright Rogue Wave Software, Inc. All rights reserved. Copyright Teradata Corporation. All rights reserved. Copyright Yahoo! Inc. All rights reserved. Copyright
Glyph & Cog, LLC. All rights reserved. Copyright Thinkmap, Inc. All rights reserved. Copyright Clearpace Software Limited. All rights reserved. Copyright Information
Builders, Inc. All rights reserved. Copyright OSS Nokalva, Inc. All rights reserved. Copyright Edifecs, Inc. All rights reserved. Copyright Cleo Communications, Inc. All rights
reserved. Copyright International Organization for Standardization 1986. All rights reserved. Copyright ej-technologies GmbH. All rights reserved. Copyright Jaspersoft
Corporation. All rights reserved. Copyright is International Business Machines Corporation. All rights reserved. Copyright yWorks GmbH. All rights reserved. Copyright
Lucent Technologies. All rights reserved. Copyright (c) University of Toronto. All rights reserved. Copyright Daniel Veillard. All rights reserved. Copyright Unicode, Inc.
Copyright IBM Corp. All rights reserved. Copyright MicroQuill Software Publishing, Inc. All rights reserved. Copyright PassMark Software Pty Ltd. All rights reserved.
Copyright LogiXML, Inc. All rights reserved. Copyright 2003-2010 Lorenzi Davide, All rights reserved. Copyright Red Hat, Inc. All rights reserved. Copyright The Board
of Trustees of the Leland Stanford Junior University. All rights reserved. Copyright EMC Corporation. All rights reserved. Copyright Flexera Software. All rights reserved.
This product includes software developed by the Apache Software Foundation (http://www.apache.org/), and other software which is licensed under the Apache License,
Version 2.0 (the "License"). You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0. Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations under the License.
This product includes software which was developed by Mozilla (http://www.mozilla.org/), software copyright The JBoss Group, LLC, all rights reserved; software copyright
1999-2006 by Bruno Lowagie and Paulo Soares and other software which is licensed under the GNU Lesser General Public License Agreement, which may be found at http://
www.gnu.org/licenses/lgpl.html. The 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.
The product includes ACE(TM) and TAO(TM) software copyrighted by Douglas C. Schmidt and his research group at Washington University, University of California, Irvine,
and Vanderbilt University, Copyright () 1993-2006, all rights reserved.
This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (copyright The OpenSSL Project. All Rights Reserved) and redistribution of
this software is subject to terms available at http://www.openssl.org and http://www.openssl.org/source/license.html.
This product includes Curl software which is Copyright 1996-2007, Daniel Stenberg, <daniel@haxx.se>. All Rights Reserved. Permissions and limitations regarding this
software are subject to terms available at http://curl.haxx.se/docs/copyright.html. Permission to use, copy, modify, and distribute this software for any purpose with or without
fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
The product includes software copyright 2001-2005 () MetaStuff, Ltd. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available
at http://www.dom4j.org/ license.html.
The product includes software copyright 2004-2007, The Dojo Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to terms
available at http://dojotoolkit.org/license.
This product includes ICU software which is copyright International Business Machines Corporation and others. All rights reserved. Permissions and limitations regarding this
software are subject to terms available at http://source.icu-project.org/repos/icu/icu/trunk/license.html.
This product includes software copyright 1996-2006 Per Bothner. All rights reserved. Your right to use such materials is set forth in the license which may be found at http://
www.gnu.org/software/ kawa/Software-License.html.
This product includes OSSP UUID software which is Copyright 2002 Ralf S. Engelschall, Copyright 2002 The OSSP Project Copyright 2002 Cable & Wireless
Deutschland. Permissions and limitations regarding this software are subject to terms available at http://www.opensource.org/licenses/mit-license.php.
This product includes software developed by Boost (http://www.boost.org/) or under the Boost software license. Permissions and limitations regarding this software are subject
to terms available at http:/ /www.boost.org/LICENSE_1_0.txt.
This product includes software copyright 1997-2007 University of Cambridge. Permissions and limitations regarding this software are subject to terms available at http://
www.pcre.org/license.txt.
This product includes software copyright 2007 The Eclipse Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to terms
available at http:// www.eclipse.org/org/documents/epl-v10.php.
This product includes software licensed under the terms at http://www.tcl.tk/software/tcltk/license.html, http://www.bosrup.com/web/overlib/?License, http://www.stlport.org/
doc/ license.html, http://www.asm.ow2.org/license.html, http://www.cryptix.org/LICENSE.TXT, http://hsqldb.org/web/hsqlLicense.html, http://httpunit.sourceforge.net/doc/
license.html, http://jung.sourceforge.net/license.txt , http://www.gzip.org/zlib/zlib_license.html, http://www.openldap.org/software/release/license.html, http://www.libssh2.org,
http://slf4j.org/license.html, http://www.sente.ch/software/OpenSourceLicense.html, http://fusesource.com/downloads/license-agreements/fuse-message-broker-v-5-3- licenseagreement; http://antlr.org/license.html; http://aopalliance.sourceforge.net/; http://www.bouncycastle.org/licence.html; http://www.jgraph.com/jgraphdownload.html; http://
www.jcraft.com/jsch/LICENSE.txt. http://jotm.objectweb.org/bsd_license.html; . http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231; http://www.slf4j.org/
license.html; http://developer.apple.com/library/mac/#samplecode/HelpHook/Listings/HelpHook_java.html; http://nanoxml.sourceforge.net/orig/copyright.html; http://
www.json.org/license.html; http://forge.ow2.org/projects/javaservice/, http://www.postgresql.org/about/licence.html, http://www.sqlite.org/copyright.html, http://www.tcl.tk/

software/tcltk/license.html, http://www.jaxen.org/faq.html, http://www.jdom.org/docs/faq.html, http://www.slf4j.org/license.html; http://www.iodbc.org/dataspace/iodbc/wiki/


iODBC/License; http://www.keplerproject.org/md5/license.html; http://www.toedter.com/en/jcalendar/license.html; http://www.edankert.com/bounce/index.html; http://www.netsnmp.org/about/license.html; http://www.openmdx.org/#FAQ; http://www.php.net/license/3_01.txt; http://srp.stanford.edu/license.txt; http://www.schneier.com/blowfish.html;
http://www.jmock.org/license.html; http://xsom.java.net; and http://benalman.com/about/license/.
This product includes software licensed under the Academic Free License (http://www.opensource.org/licenses/afl-3.0.php), the Common Development and Distribution
License (http://www.opensource.org/licenses/cddl1.php) the Common Public License (http://www.opensource.org/licenses/cpl1.0.php), the Sun Binary Code License
Agreement Supplemental License Terms, the BSD License (http:// www.opensource.org/licenses/bsd-license.php) the MIT License (http://www.opensource.org/licenses/mitlicense.php) and the Artistic License (http://www.opensource.org/licenses/artistic-license-1.0).
This product includes software copyright 2003-2006 Joe WaInes, 2006-2007 XStream Committers. All rights reserved. Permissions and limitations regarding this software
are subject to terms available at http://xstream.codehaus.org/license.html. This product includes software developed by the Indiana University Extreme! Lab. For further
information please visit http://www.extreme.indiana.edu/.
This product includes software developed by Andrew Kachites McCallum. "MALLET: A Machine Learning for Language Toolkit." http://mallet.cs.umass.edu (2002).
This Software is protected by U.S. Patent Numbers 5,794,246; 6,014,670; 6,016,501; 6,029,178; 6,032,158; 6,035,307; 6,044,374; 6,092,086; 6,208,990; 6,339,775;
6,640,226; 6,789,096; 6,820,077; 6,823,373; 6,850,947; 6,895,471; 7,117,215; 7,162,643; 7,243,110, 7,254,590; 7,281,001; 7,421,458; 7,496,588; 7,523,121; 7,584,422;
7676516; 7,720,842; 7,721,270; and 7,774,791, international Patents and other Patents Pending.
DISCLAIMER: Informatica Corporation provides this documentation "as is" without warranty of any kind, either express or implied, including, but not limited to, the implied
warranties of noninfringement, merchantability, or use for a particular purpose. Informatica Corporation does not warrant that this software or documentation is error free. The
information provided in this software or documentation may include technical inaccuracies or typographical errors. The information in this software and documentation is
subject to change at any time without notice.
NOTICES
This Informatica product (the "Software") includes certain drivers (the "DataDirect Drivers") from DataDirect Technologies, an operating company of Progress Software
Corporation ("DataDirect") which are subject to the following terms and conditions:
1. THE DATADIRECT DRIVERS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
2. IN NO EVENT WILL DATADIRECT OR ITS THIRD PARTY SUPPLIERS BE LIABLE TO THE END-USER CUSTOMER FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, CONSEQUENTIAL OR OTHER DAMAGES ARISING OUT OF THE USE OF THE ODBC DRIVERS, WHETHER OR NOT INFORMED OF
THE POSSIBILITIES OF DAMAGES IN ADVANCE. THESE LIMITATIONS APPLY TO ALL CAUSES OF ACTION, INCLUDING, WITHOUT LIMITATION, BREACH
OF CONTRACT, BREACH OF WARRANTY, NEGLIGENCE, STRICT LIABILITY, MISREPRESENTATION AND OTHER TORTS.
Part Number: PC-ING-95100-0001

Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Informatica Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Informatica Customer Portal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Informatica Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Informatica Web Site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Informatica How-To Library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Informatica Knowledge Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Informatica Multimedia Knowledge Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Informatica Global Customer Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

Chapter 1: Installation Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1


Informatica Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Installation of Multiple Products. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Installation Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Informatica Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Data Quality Application Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Informatica Clients. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Data Quality Client Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Chapter 2: Before You Begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4


Before You Begin Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
License Key. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Incremental License Key. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Uninstall Data Transformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Backing Up the Data Transformation Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Uninstalling Previous Versions of Data Transformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Chapter 3: Informatica Services Pre-Installation Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7


Informatica Services Pre-Installation Tasks Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Informatica Services Pre-Installation Tasks on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Install Java Development Kit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Verify the Minimum System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Review the Environment Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Verify the Port Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Create a System User Account. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Set Up a Keystore File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Set the File Descriptor Limit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Set Up the X Window Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Table of Contents

Extract the Installer Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11


Run the Pre-Installation (i9Pi) System Check Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Informatica Services Pre-Installation Tasks on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Verify the Minimum System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Review the Environment Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Verify the Port Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Create a System User Account. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Set Up a Keystore File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Extract the Installer Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Run the Pre-Installation (i9Pi) System Check Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Before you Create the Informatica Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Verify the Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Set Up the Domain Configuration Repository Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Chapter 4: Informatica Services Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22


Informatica Services Installation Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Create or Join a Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Installing the Informatica Services in Graphical Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Creating a Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Joining a Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Installing the Informatica Services in Console Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Creating a Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Joining a Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Installing the Informatica Services in Silent Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Configuring the Properties File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Running the Silent Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Chapter 5: Informatica Services Post-Installation Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . 55


Informatica Services Post-Installation Tasks Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Configure the Environment Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Informatica Environment Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Locale Environment Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Library Path Environment Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Verify the System Requirements for the Domain and Application Services. . . . . . . . . . . . . . . . . . . . 59
Verify the Setup for 32-bit and 64-bit Platforms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Install the Database Client Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Database Client Environment Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Verify Third Party Software Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Informatica Administrator. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
SAP Java Connector 3.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Verify the Host File Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

ii

Table of Contents

Chapter 6: Starting Informatica Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62


Starting Informatica Services Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Starting and Stopping Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Starting and Stopping Informatica on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Starting and Stopping Informatica on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Stopping Informatica in Informatica Administrator. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Rules and Guidelines for Starting or Stopping Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Logging in to Informatica Administrator. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Configuring the Informatica Windows Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Getting Started with the Data Quality Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Configure the Data Quality Modules on the Data Integration Service. . . . . . . . . . . . . . . . . . . . . . . . 67
Configure Reference Data Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Set Privileges on Reference Table Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Chapter 7: Informatica Clients Pre-Installation Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69


Informatica Clients Pre-Installation Tasks Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Verify the Minimum System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Verify the Third Party Software Required by the Informatica Developer Tools. . . . . . . . . . . . . . . 70
Verify System User Account. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Chapter 8: Informatica Clients Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71


Informatica Clients Installation Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Installing in Graphical Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Installing in Silent Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Configuring the Properties File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Running the Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Chapter 9: Informatica Clients Post-Installation Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76


Informatica Clients Post-Installation Tasks Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Verify that a Graphics Display Server is Available. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Configure the Web Browser. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Install the Languages for the Client Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Configure the Workspace Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Chapter 10: Starting Informatica Clients. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79


Starting the Developer Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Logging In to the Analyst Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Chapter 11: Troubleshooting the Informatica Installation. . . . . . . . . . . . . . . . . . . . . . . . . . 81


Installation Troubleshooting Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Installation Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Debug Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Table of Contents

iii

File Installation Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82


Service Manager Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Troubleshooting Domains and Nodes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Creating the Domain Configuration Repository. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Creating or Joining a Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Starting Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Pinging the Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Adding a License. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Troubleshooting Data Transformation Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Chapter 12: Repository Database Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86


Model Repository Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Oracle Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
IBM DB2 Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Microsoft SQL Server Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Profiling Warehouse Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Oracle Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
IBM DB2 Database Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Microsoft SQL Server Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Reference Data Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Oracle Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
IBM DB2 Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Microsoft SQL Server Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Staging Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Oracle Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
IBM DB2 Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Microsoft SQL Server Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Human Task Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Oracle Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
IBM DB2 Database Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Microsoft SQL Server Database Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Chapter 13: Informatica Platform Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92


Connectivity Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Domain Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Data Quality Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Model Repository Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Native Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
ODBC Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
JDBC Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

Chapter 14: JDBC and ODBC Driver Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98


JDBC and ODBC Driver Installation Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

iv

Table of Contents

JDBC Driver Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98


Installing the Informatica JDBC Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Updating the CLASSPATH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
ODBC Driver Installation on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Installing or Upgrading the Informatica Data Services ODBC Driver on Windows. . . . . . . . . . . . . 99
Installing the Informatica Data Services ODBC Driver 9.5 on Windows. . . . . . . . . . . . . . . . . . . . 99
Configuring the Informatica Data Services ODBC Driver for PowerCenter. . . . . . . . . . . . . . . . . . 99
Configuring the Informatica Data Services ODBC Driver 9.5.1. . . . . . . . . . . . . . . . . . . . . . . . 100
ODBC Driver Installation on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Installing or Upgrading the Informatica Data Services ODBC Driver on UNIX. . . . . . . . . . . . . . .101
Installing the Informatica Data Services ODBC Driver 9.5 on UNIX. . . . . . . . . . . . . . . . . . . . . 102

Chapter 15: Informatica Utilities Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104


Informatica Utilities Installation Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104
Command Line Programs and Utilities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105
Configuring the PowerCenter Utilities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Configuring the Metadata Manager Utilities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106

Chapter 16: Informatica Documentation Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107


Documentation Installation Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
Installing the Informatica Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Viewing the Informatica Product Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108

Chapter 17: Uninstallation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109


Uninstallation Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Rules and Guidelines for Uninstallation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Informatica Server Uninstallation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Uninstalling the Informatica Server in Graphical Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Uninstalling the Informatica Server in Console Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Uninstalling the Informatica Server in Silent Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Informatica Clients Uninstallation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112
Uninstalling Informatica Clients in Graphical Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112
Uninstalling Informatica Clients in Silent Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Appendix A: Connecting to Databases from Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . 115


Connecting to Databases from Windows Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115
Connecting to an IBM DB2 Universal Database from Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Configuring Native Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116
Connecting to Microsoft Access and Microsoft Excel from Windows. . . . . . . . . . . . . . . . . . . . . . . .116
Configuring ODBC Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116
Connecting to a Microsoft SQL Server Database from Windows. . . . . . . . . . . . . . . . . . . . . . . . . . 117
Configuring Native Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117

Table of Contents

Connecting to an Oracle Database from Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117


Configuring Native Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Connecting to a Sybase ASE Database from Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Configuring Native Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Connecting to a Teradata Database from Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Configuring ODBC Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

Appendix B: Connecting to Databases from UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121


Connecting to Databases from UNIX Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Connecting to an IBM DB2 Universal Database from UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Connecting to an IBM DB2 Universal Database from UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Connecting to Microsoft SQL Server from UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Configuring ODBC Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Configuring SSL Authentication through ODBC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Connecting to an Oracle Database from UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Configuring Native Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Connecting to a Sybase ASE Database from UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Configuring Native Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Connecting to a Teradata Database from UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Configuring ODBC Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Connecting to an ODBC Data Source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Sample odbc.ini File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

Appendix C: Updating the DynamicSections Parameter of a DB2 Database. . . . . . . . 135


DynamicSections Parameter Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Updating the DynamicSections Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Downloading and Installing the DataDirect Connect for JDBC Utility. . . . . . . . . . . . . . . . . . . . . 135
Running the Test for JDBC Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Appendix D: Installation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137


Installation Checklist Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Before You Install. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Informatica Services Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Informatica Client Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
After You Install. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

vi

Table of Contents

Preface
The Informatica Data Quality Installation and Configuration Guide is written for the system administrator who is
responsible for installing the Informatica product. This guide assumes you have knowledge of operating systems,
relational database concepts, and the database engines, flat files, or mainframe systems in your environment. This
guide also assumes you are familiar with the interface requirements for your supporting applications.

Informatica Resources
Informatica Customer Portal
As an Informatica customer, you can access the Informatica Customer Portal site at
http://mysupport.informatica.com. The site contains product information, user group information, newsletters,
access to the Informatica customer support case management system (ATLAS), the Informatica How-To Library,
the Informatica Knowledge Base, the Informatica Multimedia Knowledge Base, Informatica Product
Documentation, and access to the Informatica user community.

Informatica Documentation
The Informatica Documentation team takes every effort to create accurate, usable documentation. If you have
questions, comments, or ideas about this documentation, contact the Informatica Documentation team through
email at infa_documentation@informatica.com. We will use your feedback to improve our documentation. Let us
know if we can contact you regarding your comments.
The Documentation team updates documentation as needed. To get the latest documentation for your product,
navigate to Product Documentation from http://mysupport.informatica.com.

Informatica Web Site


You can access the Informatica corporate web site at http://www.informatica.com. The site contains information
about Informatica, its background, upcoming events, and sales offices. You will also find product and partner
information. The services area of the site includes important information about technical support, training and
education, and implementation services.

Informatica How-To Library


As an Informatica customer, you can access the Informatica How-To Library at http://mysupport.informatica.com.
The How-To Library is a collection of resources to help you learn more about Informatica products and features. It
includes articles and interactive demonstrations that provide solutions to common problems, compare features and
behaviors, and guide you through performing specific real-world tasks.

vii

Informatica Knowledge Base


As an Informatica customer, you can access the Informatica Knowledge Base at http://mysupport.informatica.com.
Use the Knowledge Base to search for documented solutions to known technical issues about Informatica
products. You can also find answers to frequently asked questions, technical white papers, and technical tips. If
you have questions, comments, or ideas about the Knowledge Base, contact the Informatica Knowledge Base
team through email at KB_Feedback@informatica.com.

Informatica Multimedia Knowledge Base


As an Informatica customer, you can access the Informatica Multimedia Knowledge Base at
http://mysupport.informatica.com. The Multimedia Knowledge Base is a collection of instructional multimedia files
that help you learn about common concepts and guide you through performing specific tasks. If you have
questions, comments, or ideas about the Multimedia Knowledge Base, contact the Informatica Knowledge Base
team through email at KB_Feedback@informatica.com.

Informatica Global Customer Support


You can contact a Customer Support Center by telephone or through the Online Support. Online Support requires
a user name and password. You can request a user name and password at http://mysupport.informatica.com.
Use the following telephone numbers to contact Informatica Global Customer Support:
North America / South America

Europe / Middle East / Africa

Asia / Australia

Toll Free

Toll Free

Toll Free

Brazil: 0800 891 0202

France: 0805 804632

Australia: 1 800 151 830

Mexico: 001 888 209 8853

Germany: 0800 5891281

New Zealand: 09 9 128 901

North America: +1 877 463 2435

Italy: 800 915 985


Netherlands: 0800 2300001
Portugal: 800 208 360

Standard Rate

Spain: 900 813 166

India: +91 80 4112 5738

Switzerland: 0800 463 200


United Kingdom: 0800 023 4632

Standard Rate
Belgium: +31 30 6022 797
France: +33 1 4138 9226
Germany: +49 1805 702 702
Netherlands: +31 306 022 797
United Kingdom: +44 1628 511445

viii

Preface

CHAPTER 1

Installation Overview
This chapter includes the following topics:
Informatica Installation, 1
Informatica Services, 2
Informatica Clients, 3

Informatica Installation
The Informatica platform consists of a server component (Informatica services) and one or more client
components. Informatica provides separate installers to install the Informatica services and clients.
The Informatica platform includes the following products:
Informatica Data Explorer
Informatica Data Quality
Informatica Data Services
Informatica Data Transformation
PowerCenter

The Informatica platform also includes components for PowerExchange, Data Services and Data Quality adapters.

Installation of Multiple Products


If you purchase more than one Informatica product, you need to install the Informatica platform only once.
Before you install Informatica, review the requirements and pre-installation tasks for the products that you
purchase. Verify that the machine where you install Informatica meets the requirements for all products. Most of
the steps in the installation process are common to all Informatica products. You need to perform these steps only
once.
Install the Informatica platform once on each machine that you want to use as a node in the Informatica domain.
Verify that you have all licenses required for the products that you want to use.
After you install the Informatica platform, review the post-installation tasks for your product. Complete the
configuration tasks for all the products you want to use. Most of the configuration tasks are common to all
Informatica products. You need to perform the common tasks only once.

Installation Tasks
To install Data Quality, complete the following tasks:
1.

Complete the pre-installation tasks. Complete the pre-installation tasks to ensure that you can successfully
run the installers and create and run the services on the domain.

2.

Install the Informatica services. Use the server installer to install the Informatica services on one or more
Windows or UNIX machines. Create a node and configure the domain. Specify the database to store the
domain configuration repository.

3.

Install the Informatica client. Use the client installer to install Informatica Developer. You can install
Informatica Developer on one or more Windows machines.

4.

Perform the post-installation configuration tasks. Prepare the databases and user accounts for the
repositories used in Data Quality. Configure the machine to ensure that you can run the domain services and
components.

After you complete the installation and configuration process, log in to Informatica Administrator and create and
configure the following services:
Model Repository Service
Data Integration Service
Analyst Service
Content Management Service
Data Director Service

Optionally, you can create a Reporting and Dashboards Service for Jaspersoft reporting.
Note: If you install the Informatica product on more than one machine, complete the first installation using the
detailed instructions in this guide. You can use the installation checklist in the appendix to perform subsequent
installations.

Informatica Services
The domain is the main administrative unit for the Informatica platform. The Informatica domain is a collection of
nodes that represent the machines on which the application services run. Each node in the domain runs a Service
Manager that manages domain operations on that node. The Service Manager manages operations and services
in the domain. You use Informatica Administrator (the Administrator tool) to manage the Informatica domain.
You can run the server installer multiple times to install the Informatica services on more than one machine.
If you install on a single machine, you create a domain and a node on the machine. If you install on multiple
machines, you can create multiple domains with one or more nodes in each domain or you can create one domain
for all nodes.
If you install on multiple machines, you must create an Informatica domain and a node when you install the
Informatica services for the first time. When you install on another machine, you can create another domain and
node, or you can create a node and join the node to an existing domain. You manage each domain through a
separate Administrator tool.
You can install the Informatica services in graphical or silent mode on Windows and in graphical, silent, or console
mode on UNIX. The installation process creates a service named Informatica that runs as a service on Windows
and as a daemon on UNIX. When you start the Informatica service, it starts the Service Manager, which manages
all domain operations.

Chapter 1: Installation Overview

Data Quality Application Services


The Informatica domain has the following application services for Data Quality:
Model Repository Service. Manages connections to the Model repository.
Data Integration Service. Performs data integration tasks for the Analyst tool and the Developer tool and stores

metadata in the Model repository.


The Data Integration Service includes modules that you select for Data Quality operations. Select the Profiling
Service Module to run profiles. Select the Human Task Service Module to run Human tasks in workflows.
Analyst Service. Runs Informatica Analyst.
Content Management Service. Manages configuration options for reference data, address validation data,

identity populations, classifier models, and probabilistic models. The service provides reference data, address
validation port lists, identity population file information, and classifier and probabilistic model information to the
Developer tool. The service provides reference data information to the Analyst Tool.
Data Director Service. Runs the Informatica Data Director for Data Quality web application in the Informatica

domain.

Informatica Clients
The Informatica clients consist of client applications and web applications that you use to access the services in
the domain. You can install the Informatica clients on Windows in graphical or silent mode.

Data Quality Client Tools


Data Quality has the following client tools:
Informatica Developer. The Developer tool is a client application that you use to create and run mappings, data

objects, and virtual databases. Objects you create in the Developer tool are stored in a Model repository and
are run by a Data Integration Service. Use the client installer to install the Developer tool. Installing the
Developer tool also installs the Data Transformation client.
The Data Transformation client installation installs Data Transformation Studio, along with document
processors, Eclipse, and a local copy of Data Transformation Engine and the repository. The Data
Transformation Studio is an Eclipse-based environment that you use to design and configure transformations.
The Data Transformation Engine converts input files into output files, while the repository stores the files for the
transformation services that are used by the Engine. If you have an existing Eclipse installation, you can install
the Data Transformation client to use the existing application. You can also install Data Transformation Studio
as a standalone application. For more information about Data Transformation, refer to the Data Transformation
documentation.
Informatica Analyst. The Analyst tool is a web application that you can use to perform data quality and data

integration tasks such as create profiles, scorecards, and mapping specifications. Objects you create in the
Analyst tool are stored in a Model repository and are run by a Data Integration Service. Use a web browser to
log in to the Analyst tool.
Informatica Data Director for Data Quality. Informatica Data Director for Data Quality is a web-based

application that allows users to view and edit database records as part of a workflow task. You use Data
Director for Data Quality to examine records that were processed in other applications and that contain
unresolved data quality issues.

Informatica Clients

CHAPTER 2

Before You Begin


This chapter includes the following topics:
Before You Begin Overview, 4
License Key, 4
Incremental License Key, 4
Uninstall Data Transformation, 5

Before You Begin Overview


Before you begin the Informatica installation, ensure that you have the license key and uninstall previous versions
of Data Transformation.

License Key
Before you install the software, verify that you have the license key available. You can get the license key in the
following ways:
Installation DVD. If you receive the Informatica installation files in a DVD, the license key file is included in the

Informatica License Key CD.


FTP download. If you download the Informatica installation files from the Informatica Electronic Software

Download (ESD) site, the license key is in an email message from Informatica. Copy the license key file to a
directory accessible to the user account that installs the product.
Contact Informatica Global Customer Support if you do not have a license key.

Incremental License Key


Contact Informatica Global Customer Support if you have an incremental license key and you want to create a
domain.

Uninstall Data Transformation


If your machine has Data Transformation 9.0.1 or earlier versions, you must uninstall it before you upgrade the
Informatica services or clients. The Informatica installation overwrites the Data Transformation configuration file.
Before you upgrade the Informatica services or clients, back up the essential Data Transformation files and
uninstall the previous version of Data Transformation.

Backing Up the Data Transformation Files


Before you install a new version of Data Transformation, you must back up the following files that were created
under previous versions:
Directory

Default Location

Workspace

C:\Documents and Settings\<user>\My Documents\Informatica\DataTransformation


\<version_number>\workspace

(Data Transformation
client only)
Repository

<INSTALL_DIR>/DataTransformation/ServiceDB

Custom Global
Components directory
(TGP files)

<INSTALL_DIR>/DataTransformation/autoInclude/user

Custom Global
Components directory
(DLL and JAR files)

<INSTALL_DIR>/DataTransformation/externLibs/user

Configuration file

<INSTALL_DIR>/DataTransformation/CMConfig.xml

License file

<INSTALL_DIR>/DataTransformation/CDELicense.cfg

Library files

<INSTALL_DIR>/DataTransformation/Libraries

Library files

The following files under <INSTALL_DIR>/DataTransformation/eclipse3_3/plugins:


- com.informatica.libeditor.compare_<version>.jar
- com.informatica.libeditor.DigesterWrap_<version>.jar
- com.informatica.libeditor.gen_wiz_<version>.jar
- com.informatica.libeditor.launcher_<version>.jar
- com.informatica.libeditor.run_validations_<version>.jar
- com.informatica.libeditor_<version>.jar
- All other plugins with names that start with com.informatica.libeditor_

SWIFT library files

com.informatica.libeditor.BicLookup_<version>.jar

FpML or SEPA library


files

- com.informatica.libeditor.propertypages_<version>.jar
- com.informatica.libeditor_xsd_<version>.jar

Uninstalling Previous Versions of Data Transformation


The installer cannot upgrade Data Transformation directly from 9.0.1 or previous versions.
If you have Data Transformation 9.0.1 or previous versions installed, you must uninstall it before you install the
current version.
1.

Close all applications that use Data Transformation services.

Uninstall Data Transformation

2.

If you are uninstalling version 9.x, uninstall all libraries.

3.

To run the uninstaller, in the Windows Control Panel, select Add or Remove Programs or Programs and
Features, depending on the Windows operating system version, and then select the option to remove Data
Transformation.
The Uninstallation window appears.

4.

Click Uninstall.
The system prompts you to shut down all services.

5.

Click Continue.
Data Transformation files are removed from the computer, essential customer customized files are backed up
in the <INSTALL_DIR>/DataTransformation_<VERSION>_Backup directory, and the system displays the following
message:
Uninstallation completed.

Note: There is no log file containing the details of the uninstall operation.

6.

Click Done.

7.

When the uninstallation is complete, move the <INSTALL_DIR>/DataTransformation_<VERSION>_Backup directory,


and then delete the installation directory and all files remaining in it.

Chapter 2: Before You Begin

CHAPTER 3

Informatica Services PreInstallation Tasks


This chapter includes the following topics:
Informatica Services Pre-Installation Tasks Overview, 7
Informatica Services Pre-Installation Tasks on UNIX, 7
Informatica Services Pre-Installation Tasks on Windows, 13
Before you Create the Informatica Domain, 18

Informatica Services Pre-Installation Tasks Overview


Before you install the Informatica services, set up the machine to meet the requirements to install and run the
Informatica platform. If the machine where you install the Informatica services is not configured correctly, the
installation can fail.
When you install the Informatica services, you create a domain configuration repository in a relational database to
store domain metadata and user accounts. Before you run the installer, set up the database for the domain
configuration repository.

Informatica Services Pre-Installation Tasks on UNIX


Before you install the Informatica services on UNIX or Linux, complete the pre-installation tasks.

Install Java Development Kit


If you are installing Informatica on AIX, HP-UX, or zLinux, install a supported version of Java Development Kit
(JDK).
For AIX: http://www.ibm.com/developerworks/java/jdk/aix/service.html#java6
For HP-UX:

https://h20392.www2.hp.com/portal/swdepot/displayProductInfo.do?productNumber=HPUXJDKJRE60
For zLinux: http://www.ibm.com/developerworks/java/jdk/linux/download.html#java6

Informatica is certified with a specific JDK version. To determine which JDK version to install, see the Informatica
Release Notes. If you have problems installing JDK, contact the JDK vendor.
The software available for download at the referenced links belongs to a third party or third parties, not Informatica
Corporation. The download links are subject to the possibility of errors, omissions or change. Informatica assumes
no responsibility for such links and/or such software, disclaims all warranties, either express or implied, including
but not limited to, implied warranties of merchantability, fitness for a particular purpose, title and non-infringement,
and disclaims all liability relating thereto.

Verify the Minimum System Requirements


Verify that your machine meets the minimum system requirements to install the Informatica server component.
RAM

Disk Space

4 GB

10 GB

Temporary Disk Space Requirements for Installation


The installer writes temporary files to the hard disk. Verify that you have enough available disk space on the
machine to support the installation. When the installation completes, the installer deletes the temporary files and
releases the disk space.
The following table lists the temporary disk space requirements during installation:
Product

Disk Space

Installer

1 GB

Informatica Services

2 GB

Review the Environment Variables


Configure the environment variables to work with the Informatica installation.
Set the environment variables before you install Informatica. The following table describes the environment
variables to review on UNIX:
Variable

Description

IATEMPDIR

Location of the temporary files created during installation. Informatica requires 1 GB


disk space for temporary files.
Configure the environment variable if you do not want to create temporary files in the /
tmp directory.

INFA_JDK_HOME

Location of the folder containing the supported Java Development Kit (JDK). Set the
INFA_JDK_HOME environment variable if you are installing Informatica on AIX, HPUX, or zLinux.
In the configuration file for your shell, for example the .bashrc file, set the
INFA_JDK_HOME environment variable to the directory that contains the JDK. Verify
that the login shell can access the INFA_JDK_HOME environment variable.

Chapter 3: Informatica Services Pre-Installation Tasks

Variable

Description

JRE_HOME

If you install the Informatica services on a machine with 32-bit or 64-bit SUSE Linux
or Linux EMT64 operating system, clear the JRE_HOME environment variable before
you start the installation.

LANG and LC_ALL

Change the locale to set the appropriate character encoding for the terminal session.
For example, set the encoding to Latin1 or ISO-8859-1 for French, EUC-JP or Shift
JIS for Japanese, or UTF-8 for Chinese or Korean. The character encoding
determines the types of characters that appear in the UNIX terminal.

LD_PRELOAD

On HP-UX, the environment variable selects the Data Transformation libjvm shared
object of the JRE.
Unset the LD_PRELOAD environment variable, if you are installing Informatica on HPUX.

PATH

The installer appends file paths required by Informatica to the PATH environment
variable. Verify that the length of the PATH environment variable does not exceed
the system limits.

Verify the Port Availability


The installer sets up the ports for components in the Informatica domain, and it designates the ports to use for
application service processes that run on the node where you install Informatica.
You can specify the port numbers to use for the components and a range of port numbers to use for the
application services. Or you can use the default port numbers provided by the installer. Verify that the port
numbers are available on the machines where you install the Informatica services.
The following table describes the ports used by Informatica:
Port Type

Description

Domain port

Port number for the node created during installation. Default is 6005.

Service Manager port

Port number used by the Service Manager on the node. The Service Manager listens for
incoming connection requests on this port. Client applications use this port to communicate
with the services in the domain. This is the port that the Informatica command line programs
use to communicate to the domain. This is also the port for the SQL data service JDBC/ODBC
driver. Default is 6006.

Service Manager shutdown


port

Port number that controls server shutdown for the domain Service Manager. The Service
Manager listens for shutdown commands on this port. Default is 6007.

Informatica Administrator port

Port number used by Informatica Administrator. Default is 6008.

Informatica Administrator
shutdown port

Port number that controls server shutdown for Informatica Administrator. Informatica
Administrator listens for shutdown commands on this port. Default is 6009.

Range of ports for


application services

Range of port numbers that can be assigned to the application service processes that run on
the node. When you create an application service in the domain, the Service Manager assigns
the first available port in this range to the service process. At a minimum, the number of ports
in the range must be at least twice the number of application service processes that will run on
the node. Default is 6013 to 6113.

Informatica Services Pre-Installation Tasks on UNIX

Guidelines for Port Configuration


The installer validates the port numbers that you specify to ensure that there will be no port conflicts in the domain.
Use the following guidelines to determine the port numbers:
The port number you specify for the domain and for each component in the domain must be unique.
The port number for the domain and domain components cannot be within the range of the port numbers that

you specify for the application service processes.


The highest number in the range of port numbers that you specify must be at least three numbers higher than

the lowest port number. For example, if the minimum port number in the range is 6400, the maximum port
number must be at least 6403.
The port numbers that you specify cannot be lower than 1025 or higher than 65535.

Create a System User Account


Create a user account specifically to run the Informatica daemon.
Verify that the user account you use to install Informatica has write permission on the installation directory.

Set Up a Keystore File


During installation, you can configure Informatica to use SSL certificates for secure communication between
Informatica Administrator and the Service Manager. The installer can generate a self-signed certificate, or you can
provide the location of a certificate signed by a certification authority.
You can use the keytool utility to generate a keystore file to store the SSL keys and certificates for a secure
connection. Keytool is a key and certificate management utility to generate and administer SSL keys and
certificates. The keys and certificates are stored in a keystore file. You can use a self-signed certificate or one
signed by a certification authority (CA). To use a certificate signed by a CA, use keytool to generate a Certificate
Signing Request (CSR) and apply for a digital identity certificate from a CA.
You can find the keytool utility in one of the following directories:
%JAVA_HOME%\jre\bin
InformaticaInstallDir\java\bin

For more information about using keytool, see the documentation on the Sun web site:
http://java.sun.com/javase/6/docs/technotes/tools/windows/keytool.html

Note: After installation, you can also configure a secure connection when you create an Analyst Service in the
domain. Use Informatica Administrator to specify the keystore files for the service.

Set the File Descriptor Limit


Verify that the operating system meets the file descriptor requirement.
Informatica service processes can use a large number of files. Set the file descriptor limit per process to 8,000 or
higher. The recommended limit is 16,000 file descriptors per process.

Set Up the X Window Server


When you run the installer in graphical mode, you must use a graphics display server. 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 the product, you can run the installer using an X Window server installed on another
machine. Use the DISPLAY variable to redirect output of the X Window server to another UNIX machine.

10

Chapter 3: Informatica Services Pre-Installation Tasks

The following table lists the commands to set the DISPLAY environment variable:
Shell

Command

Example

setenv DISPLAY <TCP/IP node of XWindow server>:0

setenv DISPLAY 10.1.50.23:0

Bash/Korn

export DISPLAY=<TCP/IP node of XWindow server>:0

export DISPLAY=10.1.50.23:0

Bourne

DISPLAY=<TCP/IP node of XWindow server>:0

DISPLAY=10.1.50.23:0

export display

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 installer uses, the installer can display incorrect labels on
the buttons.

Extract the Installer Files


Before you perform the installation, extract the installer files.
The installer files are compressed and distributed as a tar file. Use a native tar or GNU tar utility to extract the
installer files to a directory on your machine.
You can extract the installer files in the following ways:
Installation DVD. Download the Informatica tar file from the installation DVD to a directory on your machine and

then extract the installer files, or extract the installer files directly from the DVD to a directory on your machine.
FTP download. Download the Informatica installation tar file from the Informatica Electronic Software Download

(ESD) site to a directory on your machine and then extract the installer files.

Run the Pre-Installation (i9Pi) System Check Tool


If you are installing Informatica in silent mode, run the Pre-installation (i9Pi) System Check Tool to verify whether
the machine meets the system requirements for the installation.
1.

Log in to the machine with a system user account.

2.

Close all other applications.

3.

On a shell command line, run the install.sh file from the root directory.
The installer displays the message to verify that the locale environment variables are set.

4.

If the environment variables are not set, press n to exit the installer and set them as required.
If the environment variables are set, press y to continue.

5.

Press 1 to install or upgrade Informatica.

6.

Press y to run the Pre-Installation (i9Pi) System Check Tool that verifies whether the machine meets the
system requirements for the installation or upgrade.

7.

From the Informatica Pre-Installation (i9Pi) System Check Tool Welcome section, press Enter.
The System Information section appears.

8.

Type the absolute path for the installation directory.


The directory names in the path must not contain spaces or the following special characters: @|* $ # ! % ( ) { }
[],;'

Informatica Services Pre-Installation Tasks on UNIX

11

9.

Press Enter.

10.

Type the starting port number for the node that is being created or upgrade on the machine.

11.

Press Enter.
The Database and Connection Information section appears.

12.

To enter the JDBC connection information using a custom JDBC connection string, press 1. To enter the
JDBC connection information using the JDBC URL information, press 2.

13.

Enter the JDBC connection information.


To enter the connection information using a custom JDBC connection string, type the connection string.
IBM DB2: jdbc:Informatica:db2://host_name:port_no;DatabaseName=

Oracle: jdbc:Informatica:oracle://host_name:port_no;ServiceName=
SQL Server: jdbc:Informatica:sqlserver://host_name:port_no;SelectMethod=cursor;DatabaseName=
Sybase: jdbc:Informatica:sybase://host_name:port_no;DatabaseName=
Verify that the connection string contains all the connection parameters required by your database system.
To enter the connection information using the JDBC URL information, specify the JDBC URL properties.
Prompt

Description

Database type

Type of database for the domain configuration repository. Select from the following
options:
1 - Oracle
2 - Microsoft SQL Server
3 - IBM DB2
4 - Sybase ASE

Database user ID

Name for the domain configuration database user account.

Database user password

Password for the domain configuration database user account.

Database host name

Host name for the database.

Database port number

Port number for the database.

Database service name

Password for the domain configuration database user account.


Service name for Oracle and IBM DB2 databases or database name for Microsoft
SQL Server and Sybase ASE.

The tool checks the settings of the hard drive, the availability of the ports, and the configuration of the
database. After the system check is complete, the System Check Summary section appears, displaying the
results of the system check.
14.

Analyze the results of the system check.


Each requirement is listed in the table, along with one of the following check statuses:
[Pass] - The requirement meets the criteria for the Informatica installation or upgrade.
[Fail] - The requirement does not meet the criteria for the Informatica installation or upgrade. Resolve the

issue before proceeding.


[Information] - Verify the information and perform any additional tasks as outlined in the details.

The results of the system check are saved to the following file: /Server/I9PI/I9PI/en/i9Pi_summary.txt.

12

Chapter 3: Informatica Services Pre-Installation Tasks

15.

Press Enter to close the Pre-Installation (i9Pi) System Check Tool.

16.

Press n to stop the Informatica services installation or upgrade.

If the Pre-Installation (i9Pi) System Check Tool finishes with failed requirements, resolve the failed requirements
and run the Pre-Installation (i9Pi) System Check Tool again.
Note: If the Informatica Pre-Installation (i9Pi) System Check Tool check finishes with failed requirements, you can
still perform the Informatica installation or upgrade. However, it is highly recommended that you resolve the failed
requirements before proceeding.

Informatica Services Pre-Installation Tasks on Windows


Before you install the Informatica services on Windows, complete the following tasks.

Verify the Minimum System Requirements


Verify that your machine meets the minimum system requirements to install the Informatica server component.
RAM

Disk Space

4 GB

10 GB

Temporary Disk Space Requirements for Installation


The installer writes temporary files to the hard disk. Verify that you have enough available disk space on the
machine to support the installation. When the installation completes, the installer deletes the temporary files and
releases the disk space.
The following table lists the temporary disk space requirements during installation:
Product

Disk Space

Installer

1 GB

Informatica Services

605 MB

Review the Environment Variables


Configure the environment variables to work with the Informatica installation.
The following table describes environment variables to review on Windows:
Variable

Description

%TEMP%

Location of the temporary files created during installation. Informatica requires 1 GB


disk space for temporary files.

Informatica Services Pre-Installation Tasks on Windows

13

Variable

Description
Configure the environment variable if you do not want to create temporary files in the
default drive.

PATH

The installer appends file paths required by Informatica to the PATH environment
variable. Verify that the length of the PATH environment variable does not exceed
the system limits.

Verify the Port Availability


The installer sets up the ports for components in the Informatica domain, and it designates the ports to use for
application service processes that run on the node where you install Informatica.
You can specify the port numbers to use for the components and a range of port numbers to use for the
application services. Or you can use the default port numbers provided by the installer. Verify that the port
numbers are available on the machines where you install the Informatica services.
The following table describes the ports used by Informatica:
Port Type

Description

Domain port

Port number for the node created during installation. Default is 6005.

Service Manager port

Port number used by the Service Manager on the node. The Service Manager listens for
incoming connection requests on this port. Client applications use this port to communicate
with the services in the domain. This is the port that the Informatica command line programs
use to communicate to the domain. This is also the port for the SQL data service JDBC/ODBC
driver. Default is 6006.

Service Manager shutdown


port

Port number that controls server shutdown for the domain Service Manager. The Service
Manager listens for shutdown commands on this port. Default is 6007.

Informatica Administrator port

Port number used by Informatica Administrator. Default is 6008.

Informatica Administrator
shutdown port

Port number that controls server shutdown for Informatica Administrator. Informatica
Administrator listens for shutdown commands on this port. Default is 6009.

Range of ports for


application services

Range of port numbers that can be assigned to the application service processes that run on
the node. When you create an application service in the domain, the Service Manager assigns
the first available port in this range to the service process. At a minimum, the number of ports
in the range must be at least twice the number of application service processes that will run on
the node. Default is 6013 to 6113.

Guidelines for Port Configuration


The installer validates the port numbers that you specify to ensure that there will be no port conflicts in the domain.
Use the following guidelines to determine the port numbers:
The port number you specify for the domain and for each component in the domain must be unique.
The port number for the domain and domain components cannot be within the range of the port numbers that

you specify for the application service processes.

14

Chapter 3: Informatica Services Pre-Installation Tasks

The highest number in the range of port numbers that you specify must be at least three numbers higher than

the lowest port number. For example, if the minimum port number in the range is 6400, the maximum port
number must be at least 6403.
The port numbers that you specify cannot be lower than 1025 or higher than 65535.

Create a System User Account


Create a system user account to perform the installation and to run the Informatica service. Verify that the user
account that you use to install the Informatica services has write permission on the installation directory.
You can install Informatica with the user account logged in to the machine and run it under another user account.
You can create a local account or a domain account to install Informatica or run the Informatica Windows service.
Note: To access a repository on Microsoft SQL Server that uses a Windows trusted connection, create a domain
account.
The user accounts require the following permissions to run the installer or to run the Informatica Windows service:
Logged in user account. The user account must be a member of the Administrators group and have the Log

on as a service permission. Log in with this user account before you install Informatica.
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 Informatica. During installation, you can specify the user account to run the Informatica Windows service.

Set Up a Keystore File


During installation, you can configure Informatica to use SSL certificates for secure communication between
Informatica Administrator and the Service Manager. The installer can generate a self-signed certificate, or you can
provide the location of a certificate signed by a certification authority.
You can use the keytool utility to generate a keystore file to store the SSL keys and certificates for a secure
connection. Keytool is a key and certificate management utility to generate and administer SSL keys and
certificates. The keys and certificates are stored in a keystore file. You can use a self-signed certificate or one
signed by a certification authority (CA). To use a certificate signed by a CA, use keytool to generate a Certificate
Signing Request (CSR) and apply for a digital identity certificate from a CA.
You can find the keytool utility in one of the following directories:
%JAVA_HOME%\jre\bin
InformaticaInstallDir\java\bin

For more information about using keytool, see the documentation on the Sun web site:
http://java.sun.com/javase/6/docs/technotes/tools/windows/keytool.html

Note: After installation, you can also configure a secure connection when you create an Analyst Service in the
domain. Use Informatica Administrator to specify the keystore files for the service.

Extract the Installer Files


Before you perform the installation, extract the installer files.
The installer files are compressed and distributed as a zip file. Use a zip utility to extract the installer files to a
directory on your machine. Verify the zip utility version is compatible with the Windows operating system version.
When you unzip the file, verify that the zip utility also extracts empty folders.

Informatica Services Pre-Installation Tasks on Windows

15

You can extract the installer files in the following ways:


Installation DVD. Download the Informatica zip file from the installation DVD to a directory on your machine and

then extract the installer files, or extract the installer files directly from the DVD to a directory on your machine.
If you download the zip file to a directory on your machine, verify the length of the entire installation directory
path, including the zip file name, is 60 characters or less.
FTP download. Download the Informatica installation zip file from the Informatica Electronic Software Download

(END) site to a directory on your machine and then extract the installer files.

Run the Pre-Installation (i9Pi) System Check Tool


If you are installing Informatica in silent mode, run the Pre-installation (i9Pi) System Check Tool to verify whether
the machine meets the system requirements for the installation.
1.

Log in to the machine with a system user account.

2.

Close all other applications.

3.

Run the install.bat file from the root directory.

4.

Select Install or upgrade Informatica.

5.

Select Run the Pre-Installation (i9Pi) System Check Tool to verify whether the machine meets the system
requirements for the installation or upgrade.

6.

Click Start.
The Informatica Pre-Installation (i9Pi) System Check Tool Welcome page appears.

7.

Click Next.
The System Information page appears.

8.

Enter the absolute path for the installation directory. The default directory is C:\.
The directory names in the path must not contain spaces or the following special characters: @ | * $ # ! % ( )
{}[],;'

9.
10.

Enter the starting port number for the node that is being created on the machine. The default port number for
the node is 6005.
Click Next.
The Database and JDBC Connection Information page appears.

11.

Enter the domain configuration repository database information:


Prompt

Description

Database type

Type of database for the domain configuration repository. Select from the following options:
1 - Oracle
2 - Microsoft SQL Server
3 - IBM DB2
4 - Sybase ASE

Database user ID

Name for the domain configuration database user account.

Database user password

Password for the domain configuration database user account.

The domain configuration repository must be accessible to all gateway nodes in the domain.

16

Chapter 3: Informatica Services Pre-Installation Tasks

12.

Enter the JDBC connection information.


To enter the connection information using the JDBC URL information, select Specify the JDBC

connection properties and specify the JDBC URL properties.


Property

Description

Database host name

Host name for the database.

Database port number

Port number for the database.

Database service name

Service name for Oracle and IBM DB2 databases or database name for Microsoft
SQL Server and Sybase ASE.

To enter the connection information using a custom JDBC connection string, select Custom JDBC

connection string and type the connection string.


IBM DB2: jdbc:Informatica:db2://host_name:port_no;DatabaseName=
Oracle: jdbc:Informatica:oracle://host_name:port_no;ServiceName=
SQL Server: jdbc:Informatica:sqlserver://host_name:port_no;SelectMethod=cursor;DatabaseName=
Sybase: jdbc:Informatica:sybase://host_name:port_no;DatabaseName=
Verify that the connection string contains all the connection parameters required by your database system.
13.

Click Test Connection to verify that you can connect to the database, and then click OK to continue.

14.

Click Next to start the system check.


The tool checks the settings of the hard drive, the availability of the ports, and the configuration of the
database. After the system check is complete, the System Check Summary page appears, displaying the
results of the system check.

15.

Analyze the results of the system check.


Each requirement is listed, along with one of the following check statuses:
[Pass] - The requirement meets the criteria for the Informatica installation or upgrade.
[Fail] - The requirement does not meet the criteria for the Informatica installation or upgrade. Resolve the

issue before proceeding with the installation or upgrade.


[Information] - Verify the information and perform any additional tasks as outlined in the details.

The results of the system check are saved to the following file: \Server\I9PI\I9PI\en\i9Pi_summary.html.
16.

Click Done to close the Pre-Installation (i9Pi) System Check Tool.

If the Pre-Installation (i9Pi) System Check Tool finishes with failed requirements, resolve the failed requirements
and run the Pre-Installation (i9Pi) System Check Tool again.
Note: If the Informatica Pre-Installation (i9Pi) System Check Tool check finishes with failed requirements, you can
still perform the Informatica installation or upgrade. However, it is highly recommended that you resolve the failed
requirements before proceeding.

Informatica Services Pre-Installation Tasks on Windows

17

Before you Create the Informatica Domain


Informatica components store metadata in relational database repositories. The database requirements depend on
the application services that you create in the domain and the number of data integration objects that you build
and store in the repositories.
The domain stores configuration and user information in a domain configuration repository. You must set up the
database for the domain configuration repository before installation. You specify the database connection
information during installation.
Before you install the Informatica services, complete the following database setup tasks:
Verify the database requirements.
Set up the database for the domain configuration repository.

Verify the Database Requirements


Before you start the installation process, verify that the database server has adequate disk space for the domain
configuration repository and other repositories in the domain.
You must set up the database for a repository before you create the application service in the domain. You specify
the database connection information when you create the service.
The following table describes the database requirements for the domain configuration repository and other
repositories in the domain:
Informatica Component

Database Type

Disk
Space

Comments

Informatica domain
configuration repository

IBM DB2 UDB

200 MB

Set up the database schema before you start


the installation process.

200 MB

Set up the database if you enable data object


caching. Create a connection object and
associate it with a Data Integration Service.
Allocate more space based on the amount of
data you want to cache.

200 MB

Set up the database before you create the


Model Repository Service. Allocate more
space based on the amount of metadata you
want to store.

10 MB

Set up the database before you create the


Reporting and Dashboards Service.

Microsoft SQL Server


Oracle
Sybase ASE

Data object cache database

IBM DB2 UDB


Microsoft SQL Server
Oracle

Model repository

IBM DB2 UDB


Microsoft SQL Server
Oracle

Reporting and Dashboards


Service repository

IBM DB2
Microsoft SQL Server
Oracle
MySQL
PostgreSQL

18

Chapter 3: Informatica Services Pre-Installation Tasks

Set Up the Domain Configuration Repository Database


Set up a database and user account for the domain configuration repository. The domain configuration repository
stores metadata for the domain. When you install Informatica, you provide the database and user account
information for the domain configuration repository. The Informatica installer uses JDBC to communicate with the
domain configuration repository.
Use the following rules and guidelines when you set up the domain configuration database and user account:
The database must be accessible to all gateway nodes in the Informatica domain.
To prevent database errors in the domain configuration repository from affecting other repositories in the

domain, create the domain configuration repository in a separate database schema with a different database
user account.
If you create more than one domain, each domain configuration repository must have a separate user account.

For more information about configuring the database, see the documentation for your database system.

Oracle Database Requirements


Use the following guidelines when you set up the repository on Oracle:
Set the open_cursors parameter to 1000 or higher.
Verify the database user has CONNECT, RESOURCE, and CREATE VIEW privileges.

IBM DB2 Database Requirements


Use the following guidelines when you set up the repository on IBM DB2:
If the repository is in an IBM DB2 9.7 database, verify that IBM DB2 Version 9.7 Fix Pack 7 or a later fix pack is

installed.
On the IBM DB2 instance where you create the database, set the following parameters to ON:
- DB2_SKIPINSERTED
- DB2_EVALUNCOMMITTED
- DB2_SKIPDELETED
- AUTO_RUNSTATS
On the database, set the following configuration parameters:
Parameter

Value

applheapsz

8192

appl_ctl_heap_sz

8192

logfilsiz

8000

DynamicSections

3000

maxlocks

98

locklist

50000

auto_stmt_stats

ON

Before you Create the Informatica Domain

19

Parameter

Value
For IBM DB2 9.5 only.

Set the tablespace pageSize parameter to 32768 bytes.

In a single-partition database, specify a tablespace that meets the pageSize requirements. If you do not specify
a tablespace, the default tablespace must meet the pageSize requirements.
In a multi-partition database, you must specify a tablespace that meets the pageSize requirements. Define the
tablespace on a single node.
Verify the database user has CREATETAB, CONNECT, and BINDADD privileges.

Note: The default value for DynamicSections in DB2 is too low for the Informatica repositories. Informatica
requires a larger DB2 package than the default. When you set up the DB2 database for the domain configuration
repository or a Model repository, you must set the DynamicSections parameter to at least 3000. If the
DynamicSections parameter is set to a lower number, you can encounter problems when you install or run
Informatica. The following error message can appear:
[informatica][DB2 JDBC Driver]No more available statements. Please recreate your package with a larger
dynamicSections value.

Microsoft SQL Server Database Requirements


Use the following guidelines when you set up the repository on Microsoft SQL Server:
Set the read committed isolation level to READ_COMMITTED_SNAPSHOT to minimize locking contention.

To set the isolation level for the database, run the following command:
ALTER DATABASE DatabaseName SET READ_COMMITTED_SNAPSHOT ON

To verify that the isolation level for the database is correct, run the following command:
SELECT is_read_committed_snapshot_on FROM sys.databases WHERE name = DatabaseName
The database user account must have the CONNECT, CREATE TABLE, and CREATE VIEW permissions.

Sybase ASE Database Requirements


Use the following guidelines when you set up the repository on Sybase ASE:
Set the database server page size to 16K or higher. You must set the page size to 16K as this is a one-time

configuration and cannot be changed afterwards.


Set the following database locking configuration to use row-level locking:
Database Configuration

Sybase System Procedure

Value

Lock scheme

sp_configure "lock scheme"

0, datarows

Set the Sybase database option ddl in tran to TRUE.


Turn ON the Sybase database option select into/bulkcopy/pllsort.
Enable the "select" privilege for the sysobjects sytem table.
Create the following login script to disable the default VARCHAR truncation:
create procedure dbo.sp_string_rtrunc_proc as set string_rtruncation on
sp_modifylogin "user_name", "login script", sp_string_rtrunc_proc

20

Chapter 3: Informatica Services Pre-Installation Tasks

The login script is executed every time the user logs into the Sybase instance. The stored procedure sets the
parameter at the session level. The sp_modifylogin system procedure updates "user_name" with the stored
procedure as its "login script". The user must have permission to invoke the stored procedure.
Verify the database user has CREATE DEFAULT, CREATE PROCEDURE, CREATE RULE, CREATE TABLE,

and CREATE VIEW privileges.


Set the following database memory configurations to the recommended baseline values:
Database Configuration

Sybase System Procedure

Value

Maximum amount of total physical


memory

sp_configure "max memory"

2097151

Procedure cache size

sp_configure "procedure cache size"

500000

Number of open objects

sp_configure "number of open objects"

5000

Number of open indexes

sp_configure "number of open indexes"

5000

Number of open partitions

sp_configure "number of open partitions"

5000

Heap memory per user

sp_configure "heap memory per user"

49152

Number of locks

sp_configure "number of locks"

100000

Adjust the above recommended values according to the operations that are performed on the database.

Before you Create the Informatica Domain

21

CHAPTER 4

Informatica Services Installation


This chapter includes the following topics:
Informatica Services Installation Overview, 22
Installing the Informatica Services in Graphical Mode, 22
Installing the Informatica Services in Console Mode, 35
Installing the Informatica Services in Silent Mode, 45

Informatica Services Installation Overview


You can install the Informatica services on a Windows or UNIX machine. On Windows, you can run the installer in
graphical or silent mode. On UNIX, you can run the installer in graphical, console, or silent mode.
Complete the Informatica pre-installation tasks to prepare for the installation. You can install the Informatica
services on multiple machines. After installation, use Informatica Administrator to log in to the domain and create
and configure the application services.

Create or Join a Domain


Create a domain if you are installing for the first time. Join a domain if you are installing on multiple machines and
you have created a domain on another machine.
The Informatica domain is the fundamental administrative unit for services, users, and resources. A node is the
logical representation of a single machine. A domain contains one or more nodes.
If you are installing on multiple machines, you can create multiple domains. If you create a domain, the node on
this machine becomes a gateway node in the domain. You can select Enable Transport Layer Security (TLS) to
set up secure communication between services within the domain.
When you install the Informatica services, you create a node on the machine. You can create a domain and add
the node to the domain. If you do not create a domain, you can join the node to another domain.
If you join a domain, you can configure the node on this machine to be a gateway node. When you configure a
gateway node, you can select Enable HTTPS to configure a secure connection to Informatica Administrator.

Installing the Informatica Services in Graphical Mode


You can install the Informatica services in graphical mode on UNIX or Windows.

22

If you run the Pre-Installation (i9Pi) System Check Tool before you perform the installation, the installer prepopulates certain fields, including the database connection and port number fields, with the information you
entered during the system check.
If you install Informatica on the SUSE Linux Enterprise 11 platform, perform the installation in console mode or
silent mode.
On Windows, if you encounter problems when you run the install.bat file from the root directory, run the following
file:
<InformaticaInstallationDir>/server/install.exe

Creating a Domain
Create a domain if you are installing for the first time or if you want to administer nodes in separate domains.
1.

Log in to the machine with a system user account.

2.

Close all other applications.

3.

Begin the installation.


On Windows:
a.

Run install.bat from the root directory.


The Informatica 9.5.1 page appears.

b.

Select Install or upgrade Informatica.

c.

Select Run the Pre-Installation (i9Pi) System Check Tool to verify whether the machine meets the
system requirements for the installation or upgrade.

d.

Click Start.

On UNIX:
a.

Use a shell command line to run install.sh from the root directory.
The installer displays the message to verify that the locale environment variables are set.

b.

If the environment variables are not set, press n to exit the installer and set them as required. If the
environment variables are set, press y to continue.

c.

Press 1 to install or upgrade Informatica.

d.

Press n to skip the Pre-Installation (i9Pi) system check.

e.

Press g for graphical mode.


The Installation Type page appears.

f.
4.

Skip to step 5.

If you selected Run the Pre-Installation (i9Pi) System Check Tool, complete the following steps:
a.

From the Informatica Pre-Installation (i9Pi) System Check Tool Welcome page, click Next.
The System Information page appears.

b.

Enter the absolute path for the installation directory. The default directory is C:\.
The directory names in the path must not contain spaces or the following special characters: @ | * $ # !
% ( ) { } [ ] , ; '

On Windows, the installation directory path must be on the machine where you are installing Informatica.
c.

Enter the starting port number for the node that is being created on the machine. The default port number
for the node is 6005.

d.

Click Next.

Installing the Informatica Services in Graphical Mode

23

The Database and JDBC Connection Information page appears.


e.

Enter the domain configuration repository database information:


Prompt

Description

Database type

Type of database for the domain configuration repository. Select from the following
options:
1 - Oracle
2 - Microsoft SQL Server
3 - IBM DB2
4 - Sybase ASE

Database user ID

Name for the domain configuration database user account.

Database user password

Password for the domain configuration database user account.

The domain configuration repository must be accessible to all gateway nodes in the domain.
f.

Enter the JDBC connection information.


To enter the connection information using the JDBC URL information, select Specify the JDBC

connection properties and specify the JDBC URL properties.


Property

Description

Database host name

Host name for the database.

Database port number

Port number for the database.

Database service name

Service name for Oracle and IBM DB2 databases or database name for
Microsoft SQL Server and Sybase ASE.

To enter the connection information using a custom JDBC connection string, select Custom JDBC

connection string and type the connection string.


IBM DB2: jdbc:Informatica:db2://host_name:port_no;DatabaseName=
Oracle: jdbc:Informatica:oracle://host_name:port_no;ServiceName=
SQL Server: jdbc:Informatica:sqlserver://host_name:port_no;SelectMethod=cursor;DatabaseName=
Sybase: jdbc:Informatica:sybase://host_name:port_no;DatabaseName=
Verify that the connection string contains all the connection parameters required by your database
system.
g.

Click Test Connection to verify that you can connect to the database.

h.

Click Next to start the system check.


The tool checks the settings of the hard drive, the availability of the ports, and the configuration of the
database. After the system check is complete, the System Check Summary page appears, displaying
the results of the system check.

i.

24

Analyze the results of the system check.

Chapter 4: Informatica Services Installation

Each requirement is listed, along with one of the following check statuses:
[Pass] - The requirement meets the criteria for the Informatica installation or upgrade.
[Fail] - The requirement does not meet the criteria for the Informatica installation or upgrade. Resolve

the issue before proceeding with the installation or upgrade.


[Information] - Verify the information and perform any additional tasks as outlined in the details.

The results of the system check are saved to the following file: \Server\I9PI\I9PI\en\i9Pi_summary.html.
j.

Click Done to close the Pre-Installation (i9Pi) System Check Tool.


The Installation Type page appears.

k.

If the Pre-Installation (i9Pi) System Check Tool finishes with failed requirements, click Cancel to quit the
installation or upgrade. Resolve the failed requirements, and run the installation or upgrade again.
Note: If the Informatica Pre-Installation (i9Pi) System Check Tool check finishes with failed requirements,
you can still perform the Informatica installation or upgrade. However, it is highly recommended that you
resolve the failed requirements before proceeding.

5.

Select Install Informatica 9.5.1.

6.

Click Next.
The Installation Pre-Requisites page displays the installation requirements. Verify that all requirements are
met before you continue the installation.

7.

Click Next.
The License and Installation Directory page appears.

8.

Enter the path and file name of the Informatica license key.

9.

Enter the absolute path for the installation directory.


The directory names in the path must not contain spaces or the following special characters: @|* $ # ! % ( ) { }
[],;'
On Windows, the installation directory path must be on the machine where you are installing Informatica.

10.

Click Next.
The Pre-Installation Summary page appears.

11.

Review the installation information, and click Install to continue.


The installer copies the Informatica files to the installation directory. After the installer has copied the
Informatica files to the installation directory, the Domain Selection page appears.

12.

Select Create a domain.


If you create a domain, the node on the current machine becomes a gateway node on the domain. The
gateway node contains a Service Manager that manages all domain operations.

13.

To set up secure communication between services within the domain, select Enable Transport Layer
Security (TLS) for the domain.

14.

To secure the connection to Informatica Administrator, select Enable HTTPS for Informatica Administrator.
The following table describes the properties that you set for an HTTPS connection:
Property

Description

Enable HTTPS for Informatica


Administrator

Select this option to secure the connection to Informatica Administrator. To use


unsecure HTTP connection, leave the check box clear.

Port

The port to use for communication between Informatica Administrator and the Service
Manager.

Installing the Informatica Services in Graphical Mode

25

15.

Property

Description

Use a keystore file generated


by the installer

Use a self-signed keystore file generated by the installer. The installer creates a
keystore file named Default.keystore in the following location:
<InformaticaInstallationDir>\tomcat\conf\

Use an existing keystore

Use a keystore file that you create. You can use a keystore file with a self-signed
certificate or a certificate signed by a certification authority.

Keystore password

A plain-text password for the keystore file. Required if you use a keystore file that you
create.

Keystore file directory

Location of the keystore file. Required if you use a keystore file that you create.

Click Next.
The Domain Configuration Repository page appears.

16.

Enter the database and user account information for the domain configuration repository.
The domain configuration repository stores metadata for domain operations and user authentication. The
database must be accessible to all gateway nodes in the domain.
The following table describes the properties that you specify for the database and user account:

26

Property

Description

Database type

Database for the domain configuration repository. Select Oracle, IBM DB2, Microsoft
SQL Server or Sybase ASE.

Database user ID

Database user account for the domain configuration repository.

User password

Password for the database user account.

Tablespace

Available for IBM DB2. Name of the tablespace in which to create the tables. The
tablespace must be defined on a single node and the page size must be 32 KB. In a
single-partition database, if this option is not selected, the installer creates the tables in
the default tablespace. In a multi-partition database, this option must be selected.

Schema name

Available for Microsoft SQL Server. Name of the schema that will contain domain
configuration tables. If not selected, the installer creates the tables in the default
schema.

Trusted connection

Available for Microsoft SQL Server. Indicates whether to connect to Microsoft SQL
Server through a trusted connection. Trusted authentication uses the security
credentials of the current user to make the connection to Microsoft SQL Server. If not
selected, the installer uses Microsoft SQL Server authentication.

Chapter 4: Informatica Services Installation

17.

Enter the JDBC connection information.


To enter the connection information using the JDBC URL information, select Specify the JDBC

connection properties and specify the JDBC URL properties.


Property

Description

Database host name

Host name for the database.

Database port number

Port number for the database.

Database service name

Service name for Oracle and IBM DB2 databases or database name for Microsoft
SQL Server and Sybase ASE.

To enter the connection information using a custom JDBC connection string, select Custom JDBC

connection string and type the connection string.


IBM DB2: jdbc:Informatica:db2://host_name:port_no;DatabaseName=
Oracle: jdbc:Informatica:oracle://host_name:port_no;ServiceName=
SQL Server: jdbc:Informatica:sqlserver://host_name:port_no;SelectMethod=cursor;DatabaseName=
Sybase: jdbc:Informatica:sybase://host_name:port_no;DatabaseName=
Verify that the connection string contains all the connection parameters required by your database system.
18.

Click Test Connection to verify that you can connect to the database, and then click OK to continue.

19.

Click Next.
The Domain and Node Configuration page appears.

20.

Enter the information for the domain and the node that you want to create.
The following table describes the properties that you set for the domain and gateway node.
Property

Description

Domain name

Name of the domain to create. The default domain name is Domain_<MachineName>.


The name must not exceed 128 characters and must be 7-bit ASCII only. It cannot
contain a space or any of the following characters: ` % * + ; " ? , < > \ /

Node host name

Host name of the machine on which to create the node. The node host name cannot
contain the underscore (_) character. If the machine has a single network name, use the
default host name. If the a machine has multiple network names, you can modify the
default host name to use an alternate network name. Optionally, you can use the IP
address.
Note: Do not use localhost. The host name must explicitly identify the machine.

Node name

Name of the node to create on this machine. The node name is not the host name for
the machine.

Node port number

Port number for the node. The default port number for the node is 6005. If the port
number is not available on the machine, the installer displays the next available port
number.

Installing the Informatica Services in Graphical Mode

27

21.

Property

Description

Domain user name

User name for the domain administrator. You can use this user name to initially log in to
Informatica Administrator. Use the following guidelines:
- The name is not case sensitive and cannot exceed 128 characters.
- The name cannot include a tab, newline character, or the following special
characters: % * + / ? ; < >
- The name can include an ASCII space character except for the first and last
character. Other space characters are not allowed.

Domain password

Password for the domain administrator. The password must be more than 2 characters
and must not exceed 16 characters.

Confirm password

Enter the password again to confirm.

To display the default ports for the domain and node components assigned by the installer, select Display
advanced port configuration page.
The installer displays the default port numbers assigned to the domain and node. You can modify the port
numbers and specify a different range of port numbers for the application service processes. If you do not
select the option, the installer does not display the default port numbers and you cannot modify the assigned
port numbers.
a.

Click Next.

b.

In the Port Configuration page, enter the port numbers to use.


Specify the port numbers to use for the domain and node components. Also specify a range of port
numbers to use for the service processes that will run on the node. You can use the default port numbers
or specify new port numbers. Verify that the port numbers you enter are not used by other applications.
The following table describes the ports you can set.

28

Port

Description

Service Manager port

Port number used by the Service Manager on the node. The Service Manager
listens for incoming connection requests on this port. Client applications use this
port to communicate with the services in the domain. This is the port that the
Informatica command line programs use to communicate to the domain. This is also
the port for the SQL data service JDBC/ODBC driver. Default is 6006.

Service Manager shutdown


port

Port number that controls server shutdown for the domain Service Manager. The
Service Manager listens for shutdown commands on this port. Default is 6007.

Informatica Administrator
port

Port number used by Informatica Administrator. Default is 6008.

Informatica Administrator
shutdown port

Port number that controls server shutdown for Informatica Administrator.


Informatica Administrator listens for shutdown commands on this port. Default is
6009.

Chapter 4: Informatica Services Installation

22.

Port

Description

Minimum port number

Lowest port number in the range of port numbers that can be assigned to the
application service processes that run on this node. Default is 6013.

Maximum port number

Highest port number in the range of port numbers that can be assigned to the
application service processes that run on this node. Default is 6113.

Click Next.
If you are installing on UNIX, the Post-Installation Summary page appears, indicating whether the
installation completed successfully. It also shows the status of the installed components and their
configuration. Click Done to close the installer.
If you are installing on Windows, the installer creates a service to start Informatica. By default, the service
runs under the same user account as the account used for installation. You can run the Windows service
under a different user account.
a.

Select whether to run the Windows service under a different user account
The following table describes the properties that you set.
Property

Description

Run Informatica under a


different user account

Indicates whether to run the Windows service under a different user account.

User name

User account with which to run the Informatica Windows service.


Use the following format:
DomainName\UserAccount

This user account must have the Act as operating system permission.
Password

Password for the user account with which to run the Informatica Windows service.

b.

Click Next. The Post-Installation Summary page appears, indicating whether the installation completed
successfully. It also shows the status of the installed components and their configuration.

c.

Click Done to close the installer.

You can view the installation log files to get more information about the tasks performed by the installer and to
view configuration properties for the installed components.

Joining a Domain
You can join a domain if you are installing on multiple machines and you have created a domain on another
machine.
1.

Log in to the machine with a system user account.

2.

Close all other applications.

3.

Begin the installation.

Installing the Informatica Services in Graphical Mode

29

On Windows:
a.

Run install.bat from the root directory.


The Informatica 9.5.1 page appears.

b.

Select Install or upgrade Informatica.

c.

Select Run the Pre-Installation (i9Pi) System Check Tool to verify whether the machine meets the
system requirements for the installation or upgrade.

d.

Click Start.

On UNIX:
a.

Use a shell command line to run install.sh from the root directory.
The installer displays the message to verify that the locale environment variables are set.

b.

If the environment variables are not set, press n to exit the installer and set them as required. If the
environment variables are set, press y to continue.

c.

Press 1 to install or upgrade Informatica.

d.

Press n to skip the Pre-Installation (i9Pi) system check.

e.

Press g for graphical mode.


The Installation Type page appears.

f.
4.

Skip to step 5.

If you selected Run the Pre-Installation (i9Pi) System Check Tool, complete the following steps:
a.

From the Informatica Pre-Installation (i9Pi) System Check Tool Welcome page, click Next.
The System Information page appears.

b.

Enter the absolute path for the installation directory. The default directory is C:\.
The directory names in the path must not contain spaces or the following special characters: @ | * $ # !
% ( ) { } [ ] , ; '

On Windows, the installation directory path must be on the machine where you are installing Informatica.
c.

Enter the starting port number for the node that is being created on the machine. The default port number
for the node is 6005.

d.

Click Next.
The Database and JDBC Connection Information page appears.

e.

Enter the domain configuration repository database information:


Prompt

Description

Database type

Type of database for the domain configuration repository. Select from the following
options:
1 - Oracle
2 - Microsoft SQL Server
3 - IBM DB2

30

Chapter 4: Informatica Services Installation

Prompt

Description
4 - Sybase ASE

Database user ID

Name for the domain configuration database user account.

Database user password

Password for the domain configuration database user account.

The domain configuration repository must be accessible to all gateway nodes in the domain.
f.

Enter the JDBC connection information.


To enter the connection information using the JDBC URL information, select Specify the JDBC

connection properties and specify the JDBC URL properties.


Property

Description

Database host name

Host name for the database.

Database port number

Port number for the database.

Database service name

Service name for Oracle and IBM DB2 databases or database name for
Microsoft SQL Server and Sybase ASE.

To enter the connection information using a custom JDBC connection string, select Custom JDBC

connection string and type the connection string.


IBM DB2: jdbc:Informatica:db2://host_name:port_no;DatabaseName=
Oracle: jdbc:Informatica:oracle://host_name:port_no;ServiceName=
SQL Server: jdbc:Informatica:sqlserver://host_name:port_no;SelectMethod=cursor;DatabaseName=
Sybase: jdbc:Informatica:sybase://host_name:port_no;DatabaseName=
Verify that the connection string contains all the connection parameters required by your database
system.
g.

Click Test Connection to verify that you can connect to the database.

h.

Click Next to start the system check.


The tool checks the settings of the hard drive, the availability of the ports, and the configuration of the
database. After the system check is complete, the System Check Summary page appears, displaying
the results of the system check.

i.

Analyze the results of the system check.


Each requirement is listed, along with one of the following check statuses:
[Pass] - The requirement meets the criteria for the Informatica installation or upgrade.
[Fail] - The requirement does not meet the criteria for the Informatica installation or upgrade. Resolve

the issue before proceeding with the installation or upgrade.


[Information] - Verify the information and perform any additional tasks as outlined in the details.

The results of the system check are saved to the following file: \Server\I9PI\I9PI\en\i9Pi_summary.html.
j.

Click Done to close the Pre-Installation (i9Pi) System Check Tool.


The Installation Type page appears.

Installing the Informatica Services in Graphical Mode

31

k.

If the Pre-Installation (i9Pi) System Check Tool finishes with failed requirements, click Cancel to quit the
installation or upgrade. Resolve the failed requirements, and run the installation or upgrade again.
Note: If the Informatica Pre-Installation (i9Pi) System Check Tool check finishes with failed requirements,
you can still perform the Informatica installation or upgrade. However, it is highly recommended that you
resolve the failed requirements before proceeding.

5.

Select Install Informatica 9.5.1.

6.

Click Next.
The Installation Pre-Requisites page displays the installation requirements. Verify that all requirements are
met before you continue the installation.

7.

Click Next.
The License and Installation Directory page appears.

8.

Enter the path and file name of the Informatica license key.

9.

Enter the absolute path for the installation directory.


The directory names in the path must not contain spaces or the following special characters: @|* $ # ! % ( ) { }
[],;'
On Windows, the installation directory path must be on the machine where you are installing Informatica.

10.

Click Next.
The Pre-Installation Summary page appears.

11.

Review the installation information, and click Install to continue.


The installer copies the Informatica files to the installation directory. After the installer has copied the
Informatica files to the installation directory, the Domain Selection page appears.

12.

Select Join a Domain.

13.

Select the type of node that you want to create.


To create a gateway node, select Configure this node as a gateway. To create a worker node, clear the
option.

14.

Click Next.
The Domain Configuration page appears.

15.

Enter the information for the domain that you want to join.
The following table describes the properties that you specify for the domain.

32

Property

Description

Domain name

Name of the domain to join.

Gateway node host

Host name of the machine that hosts the gateway node for the domain.

Gateway node port

Port number of the gateway node.

Domain user name

User name of the administrator for the domain you want to join.

Domain password

Password for the domain administrator.

16.

Click Next. The Join Domain Node Configuration page appears.

17.

Enter the information for the node you want to create.

Chapter 4: Informatica Services Installation

The following table describes the properties that you set for the node.
Property

Description

Host name

Host name for the node. The node host name cannot contain the underscore (_)
character.
Note: Do not use localhost. The host name must explicitly identify the machine.

18.

Node name

Name of the node to create on this machine. The node name is not the host name for
the machine.

Port number

Port number for the node.

To display the default ports for the domain and node components assigned by the installer, select Display
advanced port configuration page.
The installer displays the default port numbers assigned to the domain and node. You can modify the port
numbers and specify a different range of port numbers for the application service processes. If you do not
select the option, the installer does not display the default port numbers and you cannot modify the assigned
port numbers.
a.

Click Next.

b.

In the Port Configuration page, enter the port numbers to use.


Specify the port numbers to use for the domain and node components. Also specify a range of port
numbers to use for the service processes that will run on the node. You can use the default port numbers
or specify new port numbers. Verify that the port numbers you enter are not used by other applications.
The following table describes the ports you can set.

19.

Port

Description

Service Manager port

Port number used by the Service Manager on the node. The Service Manager
listens for incoming connection requests on this port. Client applications use this
port to communicate with the services in the domain. This is the port that the
Informatica command line programs use to communicate to the domain. This is also
the port for the SQL data service JDBC/ODBC driver. Default is 6006.

Service Manager shutdown


port

Port number that controls server shutdown for the domain Service Manager. The
Service Manager listens for shutdown commands on this port. Default is 6007.

Informatica Administrator
port

Port number used by Informatica Administrator. Default is 6008.

Informatica Administrator
shutdown port

Port number that controls server shutdown for Informatica Administrator.


Informatica Administrator listens for shutdown commands on this port. Default is
6009.

Minimum port number

Lowest port number in the range of port numbers that can be assigned to the
application service processes that run on this node. Default is 6013.

Maximum port number

Highest port number in the range of port numbers that can be assigned to the
application service processes that run on this node. Default is 6113.

Click Next.
The Port Configuration page appears.

Installing the Informatica Services in Graphical Mode

33

20.

Enter the port numbers to use for the Informatica domain components.
Specify the port numbers to use for the domain and node components. Also specify a range of port numbers
to use for the service processes that will run on the node. You can use the default port numbers or specify
new port numbers. Verify that the port numbers you enter are not used by other applications.
The following table describes the ports that you specify.

21.

Port Type

Description

Service Manager port

Port number used by the Service Manager on the node. The Service Manager listens for
incoming connection requests on this port. Client applications use this port to
communicate with the services in the domain. This is the port that the Informatica
command line programs use to communicate to the domain. This is also the port for the
SQL data service JDBC/ODBC driver. Default is 6006.

Service Manager shutdown


port

Port number that controls server shutdown for the domain Service Manager. The Service
Manager listens for shutdown commands on this port. Default is 6007.

Minimum port number

Lowest port number in the range of port numbers that can be assigned to the application
service processes that run on this node.

Maximum port number

Highest port number in the range of port numbers that can be assigned to the application
service processes that run on this node.

Click Next.
If you are installing on UNIX, the Post-Installation Summary page appears, indicating whether the
installation completed successfully. It also shows the status of the installed components and their
configuration. Click Done to close the installer.
If you are installing on Windows, the installer creates a service to start Informatica. By default, the service
runs under the same user account as the account used for installation. You can run the Windows service
under a different user account.
a.

Select whether to run the Windows service under a different user account
The following table describes the properties that you set.
Property

Description

Run Informatica under a


different user account

Indicates whether to run the Windows service under a different user account.

User name

User account with which to run the Informatica Windows service.


Use the following format:
DomainName\UserAccount

This user account must have the Act as operating system permission.
Password

Password for the user account with which to run the Informatica Windows service.

b.

Click Next. The Post-Installation Summary page appears, indicating whether the installation completed
successfully. It also shows the status of the installed components and their configuration.

c.

Click Done to close the installer.

You can view the installation log files to get more information about the tasks performed by the installer and to
view configuration properties for the installed components.

34

Chapter 4: Informatica Services Installation

Installing the Informatica Services in Console Mode


You can install the Informatica services in console mode on UNIX.
When you run the installer in console mode, the words Quit and Back are reserved words. Do not use them as
input text.
If you run the Pre-Installation (i9Pi) System Check Tool before you perform the installation, the installer prepopulates certain input fields, including the database connection and port number fields, with the information you
entered during the system check.

Creating a Domain
Create a domain if you are installing for the first time or if you want to administer nodes in separate domains.
1.

Log in to the machine with a system user account.

2.

Close all other applications.

3.

On a shell command line, run the install.sh file from the root directory.
The installer displays the message to verify that the locale environment variables are set.

4.

If the environment variables are not set, press n to exit the installer and set them as required.
If the environment variables are set, press y to continue.

5.

Press 1 to install or upgrade Informatica.

6.

Press y to run the Pre-Installation (i9Pi) System Check Tool that verifies whether the machine meets the
system requirements for the installation or upgrade.

7.

If you entered y to run the Pre-Installation (i9Pi) System Check Tool, complete the following steps:
a.

From the Informatica Pre-Installation (i9Pi) System Check Tool Welcome section, press Enter.
The System Information section appears.

b.

Type the absolute path for the installation directory.


The directory names in the path must not contain spaces or the following special characters: @|* $ # ! %
( ) { } [ ] , ; ' Default is /home/toolinst.

c.

Press Enter.

d.

Type the starting port number for the node that is being created or upgrade on the machine. Default is
6005.

e.

Press Enter.

f.

To enter the JDBC connection information using a custom JDBC connection string, press 1. To enter the
JDBC connection information using the JDBC URL information, press 2.

Installing the Informatica Services in Console Mode

35

g.

Enter the JDBC connection information.


To enter the connection information using a custom JDBC connection string, type the connection

string.
IBM DB2: jdbc:Informatica:db2://host_name:port_no;DatabaseName=
Oracle: jdbc:Informatica:oracle://host_name:port_no;ServiceName=
SQL Server: jdbc:Informatica:sqlserver://host_name:port_no;SelectMethod=cursor;DatabaseName=
Sybase: jdbc:Informatica:sybase://host_name:port_no;DatabaseName=
Verify that the connection string contains all the connection parameters required by your database
system.
To enter the connection information using the JDBC URL information, specify the JDBC URL

properties.
Prompt

Description

Database type

Type of database for the domain configuration repository. Select from the following
options:
1 - Oracle
2 - Microsoft SQL Server
3 - IBM DB2
4 - Sybase ASE

Database user ID

Name for the domain configuration database user account.

Database user password

Password for the domain configuration database user account.

Database host name

Host name for the database.

Database port number

Port number for the database.

Database service name

Password for the domain configuration database user account.


Service name for Oracle and IBM DB2 databases or database name for Microsoft
SQL Server and Sybase ASE.

The tool checks the settings of the hard drive, the availability of the ports, and the configuration of the
database. After the system check is complete, the System Check Summary section appears, displaying
the results of the system check.
h.

Analyze the results of the system check.


Each requirement is listed in the table, along with one of the following check statuses:
[Pass] - The requirement meets the criteria for the Informatica installation or upgrade.
[Fail] - The requirement does not meet the criteria for the Informatica installation or upgrade. Resolve

the issue before proceeding.


[Information] - Verify the information and perform any additional tasks as outlined in the details.

The results of the system check are saved to the following file: /Server/I9PI/I9PI/en/i9Pi_summary.txt.
i.

36

Press Enter to close the Pre-Installation (i9Pi) System Check Tool.

Chapter 4: Informatica Services Installation

j.

If the Pre-Installation (i9Pi) System Check Tool finishes with failed requirements, press n to quit the
installation or upgrade. Resolve the failed requirements, and run the installation or upgrade again.
Note: If the Informatica Pre-Installation (i9Pi) System Check Tool check finishes with failed requirements,
you can still perform the Informatica installation or upgrade. However, it is highly recommended that you
resolve the failed requirements before proceeding.

8.

Press y to proceed.

9.

Press c for console mode.

10.

Press 1 to install Informatica.

11.

Type the path and file name of the Informatica license key.

12.

Press Enter.

13.

Type the absolute path for the installation directory.


The directory names in the path must not contain spaces or the following special characters: @|* $ # ! % ( ) { }
[ ] , ; ' Default is /home/toolinst.

14.

Press Enter.

15.

Review the installation information and press Enter to continue.


The installer copies the Informatica files to the installation directory.

16.

Enter 1 to create a domain.


If you create a domain, the node on the current machine becomes a gateway node on the domain. The
gateway node contains a Service Manager that manages all domain operations.

17.

To enable Transport Layer Security (TLS), press 2. To disable TLS, select 1.


If you enable Transport Layer Security (TLS), you set up secure communication between services within the
domain.

18.

Specify the connection details to Informatica Administrator.


a.

b.

Select whether to set up a secure connection to Informatica Administrator:


Option

Description

1 - Enable HTTPS for


Informatica Administrator

Set up a secure connection to Informatica Administrator.

2 - Disable HTTPS

Do not set up a secure connection to Informatica Administrator.

If you are enabling HTTPS, enter the keystore file and port number to use to secure the connection:
Option

Description

Port

Port number for the HTTPS connection.

Keystore file

Select whether to use a keystore file generated by the installer or a keystore file
you create. You can use a keystore file with a self-signed certificate or a certificate
signed by a certification authority.
1 - Use a keystore generated by the installer
2 - Use an existing keystore

Installing the Informatica Services in Console Mode

37

Option

Description
If you select to use a keystore file generated by the installer, the installer creates a
self-signed keystore file named Default.keystore in the following location:
<InformaticaInstallationDir>\tomcat\conf\

c.
19.

If you use an existing keystore, enter the password and location of the keystore file.

Select the database to use for the domain configuration repository:


Prompt

Description

Database type

Type of database for the domain configuration repository. Select from the following options:
1 - Oracle
2 - Microsoft SQL Server
3 - IBM DB2
4 - Sybase ASE

The Informatica domain configuration repository stores metadata for domain operations and user
authentication. The domain configuration repository must be accessible to all gateway nodes in the domain.
20.

21.

Enter the properties for the database and user account.


Property

Description

Database user ID

Name for the domain configuration database user account.

User password

Password for the domain configuration database user account.

If you select IBM DB2, select whether to configure a tablespace and enter the tablespace name:
Property

Description

Configure tablespace

Select whether to specify a tablespace:


1 - No
2 - Yes
In a single-partition database, if you select No, the installer creates the tables in the
default tablespace. In a multi-partition database, you must select Yes.

Tablespace

22.

23.

38

Name of the tablespace in which to create the tables. The tablespace must be defined
on a single node and the page size must be 32 K.

If you select Microsoft SQL Server, enter the following information at the prompt:
Property

Description

Schema name

Name of the schema that will contain domain configuration tables. If this parameter is
blank, the installer creates the tables in the default schema.

To enter the JDBC connection information using a custom JDBC connection string, press 1. To enter the
JDBC connection information using the JDBC URL information, press 2.

Chapter 4: Informatica Services Installation

24.

Enter the JDBC connection information.


To enter the connection information using a custom JDBC connection string, type the connection string.
IBM DB2: jdbc:Informatica:db2://host_name:port_no;DatabaseName=

Oracle: jdbc:Informatica:oracle://host_name:port_no;ServiceName=
SQL Server: jdbc:Informatica:sqlserver://host_name:port_no;SelectMethod=cursor;DatabaseName=
Sybase: jdbc:Informatica:sybase://host_name:port_no;DatabaseName=
Verify that the connection string contains all the connection parameters required by your database system.
To enter the connection information using the JDBC URL information, specify the JDBC URL properties.
Prompt

Description

Database type

Type of database for the domain configuration repository. Select from the following
options:
1 - Oracle
2 - Microsoft SQL Server
3 - IBM DB2
4 - Sybase ASE

Database user ID

Name for the domain configuration database user account.

Database user password

Password for the domain configuration database user account.

Database host name

Host name for the database.

Database port number

Port number for the database.

Database service name

Password for the domain configuration database user account.


Service name for Oracle and IBM DB2 databases or database name for Microsoft
SQL Server and Sybase ASE.

25.

26.

If the database contains a domain configuration repository for a previous domain, select to overwrite the data
or set up another database:
Option

Description

1 - OK

Enter the connection information for a new database.

2 - Continue

The installer overwrites the data in the database with new domain configuration.

Enter the following information at the prompt:


Property

Description

Domain name

Name of the domain to create. The default domain name is Domain_<MachineName>.


The name must not exceed 128 characters and must be 7-bit ASCII only. It cannot
contain a space or any of the following characters: ` % * + ; " ? , < > \ /

Node host name

Host name of the machine on which to create the node. The node host name cannot
contain the underscore (_) character. If the machine has a single network name, use the
default host name. If the a machine has multiple network names, you can modify the

Installing the Informatica Services in Console Mode

39

Property

Description
default host name to use an alternate network name. Optionally, you can use the IP
address.
Note: Do not use localhost. The host name must explicitly identify the machine.

27.

Node name

Name of the node to create on this machine. The node name is not the host name for
the machine.

Node port number

Port number for the node. The default port number for the node is 6005. If the port
number is not available on the machine, the installer displays the next available port
number.

Domain user name

User name for the domain administrator. You can use this user name to initially log in to
Informatica Administrator. Use the following guidelines:
- The name is not case sensitive and cannot exceed 128 characters.
- The name cannot include a tab, newline character, or the following special
characters: % * + / ? ; < >
- The name can include an ASCII space character except for the first and last
character. Other space characters are not allowed.

Domain password

Password for the domain administrator. The password must be more than 2 characters
and must not exceed 16 characters.

Confirm password

Enter the password again to confirm.

Select whether to display the default ports for the domain and node components assigned by the installer.
Prompt

Description

Display advanced port


configuration page

Select whether to display the port numbers for the domain and node components assigned
by the installer:
1 - No
2 - Yes
If you select Yes, the installer displays the default port numbers assigned to the domain
components. You can specify the port numbers to use for the domain and node
components. You can also specify a range of port numbers to use for the service process
that will run on the node. You can use the default port numbers or specify new port
numbers. Verify that the port numbers you enter are not used by other applications.

28.

40

If you display the port configuration page, enter new the port numbers at the prompt or press Enter to use the
default port numbers:
Port

Description

Service Manager port

Port number used by the Service Manager on the node. The Service Manager listens for
incoming connection requests on this port. Client applications use this port to
communicate with the services in the domain. This is the port that the Informatica
command line programs use to communicate to the domain. This is also the port for the
SQL data service JDBC/ODBC driver. Default is 6006.

Service Manager shutdown


port

Port number that controls server shutdown for the domain Service Manager. The
Service Manager listens for shutdown commands on this port. Default is 6007.

Chapter 4: Informatica Services Installation

Port

Description

Informatica Administrator port

Port number used by Informatica Administrator. Default is 6008.

Informatica Administrator
shutdown port

Port number that controls server shutdown for Informatica Administrator. Informatica
Administrator listens for shutdown commands on this port. Default is 6009.

Minimum port number

Lowest port number in the range of port numbers that can be assigned to the
application service processes that run on this node. Default is 6013.

Maximum port number

Highest port number in the range of port numbers that can be assigned to the
application service processes that run on this node. Default is 6113.

The Post-installation Summary indicates whether the installation completed successfully. You can view the
installation log files to get more information about the tasks performed by the installer and to view configuration
properties for the installed components.

Joining a Domain
You can join a domain if you are installing on multiple machines and you have created a domain on another
machine.
1.

Log in to the machine with a system user account.

2.

Close all other applications.

3.

On a shell command line, run the install.sh file from the root directory.
The installer displays the message to verify that the locale environment variables are set.

4.

If the environment variables are not set, press n to exit the installer and set them as required.
If the environment variables are set, press y to continue.

5.

Press 1 to install or upgrade Informatica.

6.

Press y to run the Pre-Installation (i9Pi) System Check Tool that verifies whether the machine meets the
system requirements for the installation or upgrade.

7.

If you entered y to run the Pre-Installation (i9Pi) System Check Tool, complete the following steps:
a.

From the Informatica Pre-Installation (i9Pi) System Check Tool Welcome section, press Enter.
The System Information section appears.

b.

Type the absolute path for the installation directory.


The directory names in the path must not contain spaces or the following special characters: @|* $ # ! %
( ) { } [ ] , ; ' Default is /home/toolinst.

c.

Press Enter.

d.

Type the starting port number for the node that is being created or upgrade on the machine. Default is
6005.

e.

Press Enter.

f.

To enter the JDBC connection information using a custom JDBC connection string, press 1. To enter the
JDBC connection information using the JDBC URL information, press 2.

Installing the Informatica Services in Console Mode

41

g.

Enter the JDBC connection information.


To enter the connection information using a custom JDBC connection string, type the connection

string.
IBM DB2: jdbc:Informatica:db2://host_name:port_no;DatabaseName=
Oracle: jdbc:Informatica:oracle://host_name:port_no;ServiceName=
SQL Server: jdbc:Informatica:sqlserver://host_name:port_no;SelectMethod=cursor;DatabaseName=
Sybase: jdbc:Informatica:sybase://host_name:port_no;DatabaseName=
Verify that the connection string contains all the connection parameters required by your database
system.
To enter the connection information using the JDBC URL information, specify the JDBC URL

properties.
Prompt

Description

Database type

Type of database for the domain configuration repository. Select from the following
options:
1 - Oracle
2 - Microsoft SQL Server
3 - IBM DB2
4 - Sybase ASE

Database user ID

Name for the domain configuration database user account.

Database user password

Password for the domain configuration database user account.

Database host name

Host name for the database.

Database port number

Port number for the database.

Database service name

Password for the domain configuration database user account.


Service name for Oracle and IBM DB2 databases or database name for Microsoft
SQL Server and Sybase ASE.

The tool checks the settings of the hard drive, the availability of the ports, and the configuration of the
database. After the system check is complete, the System Check Summary section appears, displaying
the results of the system check.
h.

Analyze the results of the system check.


Each requirement is listed in the table, along with one of the following check statuses:
[Pass] - The requirement meets the criteria for the Informatica installation or upgrade.
[Fail] - The requirement does not meet the criteria for the Informatica installation or upgrade. Resolve

the issue before proceeding.


[Information] - Verify the information and perform any additional tasks as outlined in the details.

The results of the system check are saved to the following file: /Server/I9PI/I9PI/en/i9Pi_summary.txt.
i.

42

Press Enter to close the Pre-Installation (i9Pi) System Check Tool.

Chapter 4: Informatica Services Installation

j.

If the Pre-Installation (i9Pi) System Check Tool finishes with failed requirements, press n to quit the
installation or upgrade. Resolve the failed requirements, and run the installation or upgrade again.
Note: If the Informatica Pre-Installation (i9Pi) System Check Tool check finishes with failed requirements,
you can still perform the Informatica installation or upgrade. However, it is highly recommended that you
resolve the failed requirements before proceeding.

8.

Press y to proceed.

9.

Press c for console mode.

10.

Press 1 to install Informatica.

11.

Type the path and file name of the Informatica license key.

12.

Press Enter.

13.

Type the absolute path for the installation directory.


The directory names in the path must not contain spaces or the following special characters: @|* $ # ! % ( ) { }
[ ] , ; ' Default is /home/toolinst.

14.

Press Enter.

15.

Review the installation information and press Enter to continue.


The installer copies the Informatica files to the installation directory.

16.

Press 2 to join a domain.


The installer creates a node on this machine. You can specify the type of node to create and the domain to
join.

17.

Select the type of node you want to create.


Property

Description

Configure this node as a


gateway

Select whether to configure the node as a gateway or worker node.


1 - Yes
2 - No
Select 1 to configure a gateway node or 2 to configure a worker node.

18.

At the prompt, enter the information for the domain that you want to join.
Property

Description

Domain name

Name of the domain to join.

Gateway node host

Host name of the machine that hosts the gateway node for the domain.

Gateway node port

Port number of the gateway node.

Domain user name

User name of the administrator for the domain you want to join.

Domain password

Password for the domain administrator.

Installing the Informatica Services in Console Mode

43

19.

At the prompt, enter the information for the node that you want to create.
Property

Description

Host name

Host name for the node. The node host name cannot contain the underscore (_)
character.
Note: Do not use localhost. The host name must explicitly identify the machine.

20.

Node name

Name of the node to create on this machine. The node name is not the host name for
the machine.

Port number

Port number for the node.

Select whether to display the default ports for the domain and node components assigned by the installer.
Prompt

Description

Display advanced port


configuration page

Select whether to display the port numbers for the domain and node components assigned
by the installer:
1 - No
2 - Yes
If you select Yes, the installer displays the default port numbers assigned to the domain
components. You can specify the port numbers to use for the domain and node
components. You can also specify a range of port numbers to use for the service process
that will run on the node. You can use the default port numbers or specify new port
numbers. Verify that the port numbers you enter are not used by other applications.

21.

If you display the port configuration page, enter new port numbers at the prompt or press Enter to use the
default port numbers.
Port Type

Description

Service Manager port

Port number used by the Service Manager on the node. The Service Manager listens for
incoming connection requests on this port. Client applications use this port to
communicate with the services in the domain. This is the port that the Informatica
command line programs use to communicate to the domain. This is also the port for the
SQL data service JDBC/ODBC driver. Default is 6006.

Service Manager shutdown


port

Port number that controls server shutdown for the domain Service Manager. The Service
Manager listens for shutdown commands on this port. Default is 6007.

Minimum port number

Lowest port number in the range of port numbers that can be assigned to the application
service processes that run on this node.

Maximum port number

Highest port number in the range of port numbers that can be assigned to the application
service processes that run on this node.

The Post-installation Summary indicates whether the installation completed successfully. You can view the
installation log files to get more information about the tasks performed by the installer and to view configuration
properties for the installed components.

44

Chapter 4: Informatica Services Installation

Installing the Informatica Services in Silent Mode


To install the Informatica services without user interaction, install in silent mode.
Use a properties file to specify the installation options. The installer reads the file to determine the installation
options. You can use silent mode installation to install the Informatica services on multiple machines on the
network or to standardize the installation across machines.
Copy the Informatica installation files to the hard disk on the machine where you plan to install the Informatica. If
you install on a remote machine, verify that you can access and create files on the remote machine.
To install in silent mode, complete the following tasks:
1.

Configure the installation properties file and specify the installation options in the properties file.

2.

Run the installer with the installation properties file.

Configuring the Properties File


Informatica provides a sample properties file that includes the parameters that are required by the installer. You
can customize the sample properties file to specify the options for your installation. Then run the silent installation.
The sample SilentInput.properties file is stored in the root directory of the DVD or the installer download location.
After you customize the file, re-save it with the file name SilentInput.properties.
1.

Go to the root of the directory that contains the installation files.

2.

Locate the sample SilentInput.properties file.

3.

Create a backup copy of the SilentInput.properties file.

4.

Use a text editor to open the file and modify the values of the installation parameters.
The following table describes the installation parameters that you can modify:
Property Name

Description

LICENSE_KEY_LOC

Absolute path and file name of the license key file.

USER_INSTALL_DIR

Directory in which to install Informatica.

INSTALL_TYPE

Indicates whether to install or upgrade Informatica.


If the value is 0, the installer performs a fresh installation of Informatica. If the value is
1, the installer upgrades a previous version of Informatica.

HTTPS_ENABLED

Indicates whether to secure the connection to Informatica Administrator. If the value is


0, the installer sets up an unsecure HTTP connection to Informatica Administrator. If
the value is 1, the installer sets up a secure HTTPS connection to Informatica
Administrator.

DEFAULT_HTTPS_ENABLED

Indicates whether the installer creates a keystore file.


If the value is 1, the installer creates a keystore and uses it for the HTTPS connection.
If the value is 0, the installer uses a keystore file that you specify.

CUSTOM_HTTPS_ENABLED

Indicates whether the installer uses an existing keystore file.


If the value is 1, the installer uses a keystore file that you specify. If
DEFAULT_HTTPS_ENABLED=1, you must set this parameter to 0. If
DEFAULT_HTTPS_ENABLED=0, you must set this parameter to 1.

Installing the Informatica Services in Silent Mode

45

Property Name

Description

KSTORE_PSSWD

Plain text password for the keystore file.

KSTORE_FILE_LOCATION

Absolute path and file name of the keystore file.

HTTPS_PORT

Port number to use for the secure connection to Informatica Administrator.

CREATE_DOMAIN

Indicates whether to create an Informatica domain.


If the value is 1, the installer creates a node and an Informatica domain. If the value is
0, the installer creates a node and joins the node to another domain created in a
previous installation.

JOIN_DOMAIN

Indicates whether to join the node to another domain created in a previous installation.
If the value is 1, the installer creates a node and joins the node to another domain. If
CREATE_DOMAIN=1, you must set this parameter to 0. If CREATE_DOMAIN=0, you
must set this parameter to 1.

SSL_ENABLED

Enables or disables Transport Layer Security (TLS).


Indicates whether to set up secure communication between services within the
domain. If the value is true, secure communication between services within the domain
is enabled. You can set this property to true if CREATE_DOMAIN=1. You must set this
property to true if JOIN_DOMAIN=1.

SERVES_AS_GATEWAY

Indicates whether to create a gateway or worker node.


If the value is 1, the installer configures the node as a gateway node. If the value is 0,
the installer configures the node as a worker node.

DB_TYPE

Database for the domain configuration repository. Enter one of the following values:
- Oracle
- MSSQLServer
- DB2
- Sybase

DB_UNAME

Database user account name for the domain configuration repository.

DB_PASSWD

Password for the database user account.

SQLSERVER_SCHEMA_NAM
E

For Microsoft SQL Server. Name of the schema that will contain domain configuration
tables. If this parameter is empty, the installer creates the tables in the default schema.

TRUSTED_CONNECTION

For Microsoft SQL Server. Indicates whether to connect to Microsoft SQL Server
through a trusted connection. If this parameter is empty, the installer uses Microsoft
SQL Server authentication.
Set this parameter only if you are installing on Windows.

DB2_TABLESPACE

For IBM DB2. Name of the tablespace in which to create the tables. If this parameter is
empty, the installer creates the tables in the default tablespace. In a multi-partition
database, the tablespace page size must be 32 K. Define the database in a singlenode tablespace to optimize performance.

DB_CUSTOM_STRING_SELE
CTION

Determines whether to use a JDBC URL or a custom connection string to connect to


the domain configuration database.
If the value is 0, the installer creates a JDBC URL from the database properties you
provide. If the value is 1, the installer uses the custom connection string you provide.

DB_SERVICENAME

46

Chapter 4: Informatica Services Installation

Required if DB_CUSTOM_STRING_SELECTION=0.

Property Name

Description
Service name for Oracle and IBM DB2 databases.
Database name for Microsoft SQL Server and Sybase ASE.

DB_ADDRESS

Required if DB_CUSTOM_STRING_SELECTION=0.
Host name and port number for the database instance in the format HostName:Port.

ADVANCE_JDBC_PARAM

You can set this parameter if DB_CUSTOM_STRING_SELECTION=0.


Optional parameters to include in the JDBC URL connection string. Verify that the
parameter string is valid. The installer does not validate the parameter string before it
adds the string to the JDBC URL. If this parameter is empty, the installer creates the
JDBC URL without additional parameters.

DB_CUSTOM_STRING

Required if DB_CUSTOM_STRING_SELECTION=1.
Valid custom JDBC connection string.

DOMAIN_NAME

Required if CREATE_DOMAIN=1.
Name of the domain to create. The default domain name is Domain_<MachineName>.
The name must not exceed 128 characters and must be 7-bit ASCII only. It cannot
contain a space or any of the following characters: ` % * + ; " ? , < > \ /

DOMAIN_HOST_NAME

If you create a domain, this is the host name of the machine on which to create the
node. If the machine has a single network name, use the default host name. If the
machine has multiple network names, you can modify the default host name to use an
alternate network name. Optionally, you can use the IP address.
If you join a domain, this is the host name of the machine that hosts the gateway node
of the domain you want to join.
Note: Do not use localhost. The host name must explicitly identify the machine.

NODE_NAME

Name of the node to create on this machine. The node name is not the host name for
the machine.

DOMAIN_PORT

If you create a domain, this is the port number for the node to create. The default port
number for the node is 6005. If the default port number is not available on the
machine, the installer displays the next available port number.
If you join a domain, this is the port number of the gateway node of the domain you
want to join.

DOMAIN_USER

User name for the domain administrator.


If you create a domain, you can use this user name to initially log in to Informatica
Administrator. Use the following guidelines:
- The name is not case sensitive and cannot exceed 128 characters.
- The name cannot include a tab, newline character, or the following special
characters: % * + \ / ' . ? ; < >
- The name can include an ASCII space character except for the first and last
character. Other space characters are not allowed.
If you join a domain, this is the user name to use to log in to the domain that you want
to join.

DOMAIN_PSSWD

Password for the domain administrator. The password must be more than 2 characters
but cannot exceed 16 characters.

DOMAIN_CNFRM_PSSWD

Enter the password again to confirm.

JOIN_NODE_NAME

Required if JOIN_DOMAIN=1.

Installing the Informatica Services in Silent Mode

47

Property Name

Description
Name of the node to create on this machine. The node name is not the host name for
the machine.

JOIN_HOST_NAME

Required if JOIN_DOMAIN=1.
Host name of the machine that hosts the gateway node of the domain you want to join.

JOIN_DOMAIN_PORT

Required if JOIN_DOMAIN=1.
Port number of the gateway node of the domain you want to join.

ADVANCE_PORT_CONFIG

Indicates whether to display the list of port numbers for the domain and node
components. If the value is 0, the installer assigns default port numbers to the domain
and node components. If the value is 1, you can set the port numbers for the domain
and node components.

MIN_PORT

You can set this parameter if ADVANCE_PORT_CONFIG=1.


Lowest port number in the range of port numbers that can be assigned to the
application service processes that run on this node.

MAX_PORT

You can set this parameter if ADVANCE_PORT_CONFIG=1.


Highest port number in the range of port numbers that can be assigned to the
application service processes that run on this node.

TOMCAT_PORT

You can set this parameter if ADVANCE_PORT_CONFIG=1.


Port number used by the Service Manager on the node. The Service Manager listens
for incoming connection requests on this port. Client applications use this port to
communicate with the services in the domain. This is the port that the Informatica
command line programs use to communicate to the domain. This is also the port for
the SQL data service JDBC/ODBC driver. Default is 6006.

AC_PORT

You can set this parameter if CREATE_DOMAIN=1 and ADVANCE_PORT_CONFIG=1.


Port number used by Informatica Administrator. Default is 6007.

SERVER_PORT

You can set this parameter if ADVANCE_PORT_CONFIG=1.


Port number that controls server shutdown for the domain Service Manager. The
Service Manager listens for shutdown commands on this port. Default is 6008.

AC_SHUTDWN_PORT

You can set this parameter if CREATE_DOMAIN=1 and ADVANCE_PORT_CONFIG=1.


Port number that controls server shutdown for Informatica Administrator. Informatica
Administrator listens for shutdown commands on this port. Default is 6009.

5.

On Windows, specify whether to run the Informatica service under the same user account as the account
used for installation.
Set the following parameters:
Property

Description

USE_LOGIN_DETAILS

Indicates whether to run the Windows service under a different user account. If the value
is 0, the installer configures the service to run under the current user account. If the value
is 1, the installer configures the service to run under a different user account.

WIN_USER_ID

User account with which to run the Informatica Windows service.


Use the following format:
DomainName\UserAccount

48

Chapter 4: Informatica Services Installation

Property

Description
This user account must have the Act as operating system permission.

WIN_USER_PSSWD

6.

Password for the user account with which to run the Informatica Windows service.

Save the properties file with the name SilentInput.properties.

Sample Properties File


The following example shows the contents of the sample SilentInput.properties file:
##########################################################
# Informatica Installer Build Details
# Copyright (c) Informatica Corporation 1998 - 2012
# This software contains confidential and proprietary
# information of Informatica Corporation.
# All Rights Reserved.
##########################################################
#######
# Use this file (SilentInput.properties) to install Informatica services without user interaction.
#
Use this sample properties file to define the parameters for the silent installation.
#
To upgrade Informatica, use the SilentInput_upgrade.properties or
SilentInput_upgrade_NewConfig.properties file.
# Use the following guidelines when you edit this file:
#
Back up the file before you modify it.
#
Any error condition that causes the installation to fail, such as an installation directory that
is not valid,
#
generates a log file in SYSTEM_DRIVE_ROOT. For example: c:\silentErrorLog.log
#######
# The LICENSE_KEY_LOC property represents the absolute path and file name of the license key file.
#
Set the property if you are installing or upgrading Informatica.
LICENSE_KEY_LOC=c:\license.key
# The USER_INSTALL_DIR property represents the directory in which to install the new version of
Informatica.
#
Set the property if you are installing or upgrading Informatica.
#
The property must point to a valid directory with write permissions enabled.
USER_INSTALL_DIR=c:\Informatica\9.5.1
# The INSTALL_TYPE property determines whether to install or upgrade Informatica.
#
Set INSTALL_TYPE=0 to perform a new installation of Informatica.
#
To upgrade Informatica, use the SilentInput_upgrade.properties file.
#
To upgrade Informatica to a different node configuration, use the
SilentInput_upgrade_NewConfig.properties file.
INSTALL_TYPE=0
# The HTTPS_ENABLED property determines whether to secure the connection to Informatica Administrator.
#
Value
0
Use HTTP connection. Set up an unsecure HTTP connection to Informatica
Administrator.
#
Value
1
Use HTTPS connection. Set up a secure HTTPS connection to the Informatica
Administrator.
HTTPS_ENABLED=0
# The DEFAULT_HTTPS_ENABLED property determines whether the installer creates a keystore file.
#
Set the property if HTTPS_ENABLED=1 (uses HTTPS connection).
#
Value
0
Use a keystore file that you specify.
#
Value
1
Create a keystore and use it for the HTTPS connection.

Installing the Informatica Services in Silent Mode

49

DEFAULT_HTTPS_ENABLED=1
# The CUSTOM_HTTPS_ENABLED property determines whether the installer uses an existing keystore file.
#
Value
0
Set the property to 0 if DEFAULT_HTTPS_ENABLED=1.
#
Value
1
Install Informatica using a keystore file that you specify. Set the property to 1
if DEFAULT_HTTPS_ENABLED=0.
CUSTOM_HTTPS_ENABLED=0
# The KSTORE_PSSWD property represents the password for the keystore file.
#
Set the property to the plain text password for the keystore file if CUSTOM_HTTPS_ENABLED=1.
KSTORE_PSSWD=MyKeystorePassword
# The KSTORE_FILE_LOCATION property represents the location of the keystore file.
#
Set the property to the absolute path and file name of the keystore file if
CUSTOM_HTTPS_ENABLED=1.
KSTORE_FILE_LOCATION=c:\MyKeystoreFile
# The HTTPS_PORT property represents the port number to use for the secure connection to Informatica
Administrator.
HTTPS_PORT=8443
# The CREATE_DOMAIN property determines whether to create an Informatica domain.
#
Value
0
Create a node and join the node to another domain created in a previous
installation. Set the property to 0 if JOIN_DOMAIN=1.
#
Value
1
Create a node and an Informatica domain.
CREATE_DOMAIN=1
# The JOIN_DOMAIN property determines whether to join the node to another domain created in a previous
installation.
#
Value
0
Create a node and an Informatica domain. Set the property to 0 if CREATE_DOMAIN=1.
#
Value
1
Create a node and join the node to another domain created in a previous
installation. Set the property to 1 if CREATE_DOMAIN=0.
JOIN_DOMAIN=0
# The SSL_ENABLED property enables or disables Transport Layer Security (TLS).
#
Set the property to true to enable secure communication between services within the domain.
#
Set the property to true or false if CREATE_DOMAIN=1.
#
The property will not be used if JOIN_DOMAIN=1, as the node will get added on the basis of domain
security.
SSL_ENABLED=false
# The SERVES_AS_GATEWAY property determines whether to create a gateway or worker node.
#
Set the property if JOIN_DOMAIN=1.
#
Value
0
The installer configures the node as a worker node.
#
Value
1
The installer configures the node as a gateway node.
SERVES_AS_GATEWAY=0
# The DB_TYPE property represents the database type for the domain configuration database.
#
Set the property to one of the following database types (case-sensitive): Oracle, MSSQLServer,
DB2, or Sybase
DB_TYPE=Oracle/MSSQLServer/DB2/Sybase
# The DB_UNAME property represents the database user account name for the domain configuration
repository.
DB_UNAME=UserName
# The DB_PASSWD property represents the database password for the database user account.

50

Chapter 4: Informatica Services Installation

DB_PASSWD=UserPassword
# The SQLSERVER_SCHEMA_NAME property represents the name of the schema that will contain domain
configuration tables.
#
Set the property if DB_TYPE=MSSQLServer.
#
If SQLSERVER_SCHEMA_NAME is empty, the installer creates the tables in the default schema.
SQLSERVER_SCHEMA_NAME=
# The TRUSTED_CONNECTION property determines whether to connect to the Microsoft SQL Server database
through a
#
trusted connection using the Windows credentials of the current user account.
#
Set the property if DB_TYPE=MSSQLServer and you are installing on Windows.
#
Set TRUSTED_CONNECTION=0 if DB_TYPE is set to another database type or if you are installing
Informatica on Linux or UNIX.
#
If the property is empty, the installer uses Microsoft SQL Server authentication.
#
Value
0
Connect to the Microsoft SQL Server database using a Microsoft SQL Server user
account.
#
Value
1
Connect to the Microsoft SQL Server database through a trusted connection using
the Windows credentials of the current user account.
TRUSTED_CONNECTION=0
# The DB2_TABLESPACE property represents the name of the tablespace in which to create the tables.
#
Set the property if DB_TYPE=DB2.
#
If DB2_TABLESPACE is empty, the installer creates the tables in the default tablespace.
#
In a multi-partition database, the tablespace page size must be 32K.
#
Define the database in a single node tablespace to optimize performance.
DB2_TABLESPACE=
# The DB_CUSTOM_STRING_SELECTION property determines whether to use a JDBC URL or a custom connection
string to connect to the domain configuration database.
#
Set DB_CUSTOM_STRING_SELECTION=1 if TRUSTED_CONNECTION=1. Also provide the default valid
connection string in DB_CUSTOM_STRING.
#
Value
0
The installer creates a JDBC URL from the database properties you provide
#
Value
1
The installer uses the custom connection string you provide.
DB_CUSTOM_STRING_SELECTION=0
# The DB_SERVICENAME property represents the service name or database name of the database.
#
Set the property if DB_CUSTOM_STRING_SELECTION=0.
#
Set the property to the service name for Oracle and IBM DB2 databases.
#
Set the property to the database name for Microsoft SQL Server and Sybase ASE databases.
#
Leave the property blank if DB_CUSTOM_STRING_SELECTION=1.
DB_SERVICENAME=DBServiceName
# The DB_ADDRESS property represents the host name and port number for the database instance.
#
Set the property if DB_CUSTOM_STRING_SELECTION=0.
#
Set the property in the format HostName:PortNumber.
#
Leave the property blank if DB_CUSTOM_STRING_SELECTION=1.
DB_ADDRESS=HostName:PortNumber
# The ADVANCE_JDBC_PARAM property represents additional parameters in the JDBC URL connection string.
#
If DB_CUSTOM_STRING_SELECTION=0, you can set the property to include optional parameters in the
JDBC URL connection string.
#
The parameter string must be valid.
#
If the parameter is empty, the installer creates the JDBC URL without additional parameters.
ADVANCE_JDBC_PARAM=
# The DB_CUSTOM_STRING property represents a valid custom JDBC connection string.
#
Set the property if DB_CUSTOM_STRING_SELECTION=1.
DB_CUSTOM_STRING=

Installing the Informatica Services in Silent Mode

51

# The DOMAIN_NAME property represents the name of the domain to create. The default domain name is
Domain_<MachineName>.
#
Set the property if CREATE_DOMAIN=1.
#
The domain name must not exceed 128 characters and must be 7-bit ASCII only. It cannot contain a
space or any of the following characters: ` % * + ; " ? , < > \ /
DOMAIN_NAME=DomainName
# The DOMAIN_HOST_NAME property represents the host name of the machine.
#
* If you create a domain, this is the host name of the machine on which to create the node.
#
If the machine has a single network name, use the default host name.
#
If the machine has multiple network names, you can modify the default host name to use an
alternate network name. Optionally, you can use the IP address.
#
* If you join a domain, this is the host name of the machine that hosts the gateway node of the
domain you want to join.
#
Do not use localhost. The host name must explicitly identify the machine.
DOMAIN_HOST_NAME=HostName
# The NODE_NAME property represents the node to create on the machine. The node name is not the host
name for the machine.
NODE_NAME=NodeName
# The DOMAIN_PORT property represents the port number.
#
* If you create a domain, set the property to the port number for the node to create.
#
The default port number for the node is 6005.
#
If the default port number is not available on the machine, the installer displays the next
available port number.
#
* If you join a domain, set the property to the port number of the gateway node of the domain you
want to join.
DOMAIN_PORT=
# The DOMAIN_USER property represents the user name for the domain administrator.
#
If you create a domain, you can use this user name to initially log in to the Informatica
Administrator.
#
If you join a domain, this is the user name to use to log in to the domain that you want to join.
DOMAIN_USER=AdminUser
# The DOMAIN_PSSWD property represents the password for the domain administrator.
#
The password must be more than 2 characters but cannot exceed 16 characters.
DOMAIN_PSSWD=AdminUserPassword
# The DOMAIN_CNFRM_PSSWD property confirms the password you set for the domain administrator.
#
Set the property to the password you set in the DOMAIN_PSSWD property to confirm the password.
DOMAIN_CNFRM_PSSWD=AdminUserPassword
# The JOIN_NODE_NAME property represents the name of the node to create on this machine. The node name
is not the host name for the machine.
#
Set the property if JOIN_DOMAIN=1.
JOIN_NODE_NAME=NodeName
# The JOIN_HOST_NAME property represents the host name of the machine that hosts the gateway node of
the domain you want to join.
#
Set the property if JOIN_DOMAIN=1.
JOIN_HOST_NAME=DomainHostName
# The JOIN_DOMAIN_PORT property represents the port number of the gateway node of the domain you want
to join.

52

Chapter 4: Informatica Services Installation

Set the property if JOIN_DOMAIN=1.

JOIN_DOMAIN_PORT=
# The ADVANCE_PORT_CONFIG property determines whether to display the list of port numbers for the
domain and node components.
#
If ADVANCE_PORT_CONFIG=1, set the MIN_PORT, MAX_PORT, TOMCAT_PORT, AC_PORT, SERVER_PORT, and
AC_SHUTDWN_PORT properties.
#
Value
0
The installer assigns default port numbers to the domain and node components.
#
Value
1
You can manually set the port numbers for the domain and node components.
ADVANCE_PORT_CONFIG=0
# The MIN_PORT property represents the lowest port number in the range of port numbers that can be
assigned to the application service processes that run on this node.
#
Set the property if ADVANCE_PORT_CONFIG=1.
MIN_PORT=
# The MAX_PORT property represents the highest port number in the range of port numbers that can be
assigned to the application service processes that run on this node.
#
Set the property if ADVANCE_PORT_CONFIG=1.
MAX_PORT=
# The TOMCAT_PORT property represents the port number used by the Service Manager on the node. Default
is 6006.
#
Set the property if ADVANCE_PORT_CONFIG=1.
#
The Service Manager listens for incoming connection requests on this port.
#
Client applications use this port to communicate with the services in the domain.
#
This is the port that the Informatica command line programs use to communicate with the domain.
#
This is also the port for the SQL data service JDBC/ODBC driver.
TOMCAT_PORT=
# The AC_PORT property represents the port number used by Informatica Administrator. Default is 6007.
#
Set the property if CREATE_DOMAIN=1 and ADVANCE_PORT_CONFIG=1.
AC_PORT=
# The SERVER_PORT property controls the server shutdown for the domain Service Manager. The Service
Manager listens for shutdown commands on this port. Default is 6008.
#
Set the property if ADVANCE_PORT_CONFIG=1.
SERVER_PORT=
# The AC_SHUTDWN_PORT property represents the port number that controls the server shutdown for
Informatica Administrator. Default is 6009.
#
Set the property if ADVANCE_PORT_CONFIG=1.
#
Informatica Administrator listens for shutdown commands on this port.
AC_SHUTDWN_PORT=
#######
# On Windows, set the following properties to specify whether to run the Informatica service under the
same user account as the account used for installation.
#######
# The USE_LOGIN_DETAILS property determines whether to run the Windows service under a different user
account.
#
Value
0
The installer configures the service to run under the current user account.
#
Value
1
The installer configures the service to run under a different user account.
USE_LOGIN_DETAILS=0
# The WIN_USER_ID property represents the user account with which to run the Informatica Windows
service.

Installing the Informatica Services in Silent Mode

53

#
#
#

Set the property if USE_LOGIN_DETAILS=1.


The user account must have the "Act as part of the operating system" permission.
Use the format DomainName\UserAccount.

WIN_USER_ID=WindowsUserAcct
# The WIN_USER_PSSWD property represents the password for the user account with which to run the
Informatica Windows service.
WIN_USER_PSSWD=WindowsUserPassword
#######
# After you create the properties file, save the file with the name SilentInput.properties and
#
run the silent installer to perform the Informatica services installation.
#######

Running the Silent Installer


After you configure the properties file, open a command window to start the silent installation.
1.

Open a command window.

2.

Go to the root of the directory that contains the installation files.

3.

Verify that the directory contains the file SilentInput.properties that you edited and resaved.

4.

Run the silent installation. On Windows, double-click the file silentInstall.bat. On UNIX, run silentInstall.sh.

The silent installer runs in the background. The process can take a while. The silent installation is complete when
the Informatica_<Version>_Services_InstallLog.log file is created in the installation directory.
The silent installation fails if you incorrectly configure the properties file or if the installation directory is not
accessible. View the installation log files and correct the errors. Then run the silent installation again.

54

Chapter 4: Informatica Services Installation

CHAPTER 5

Informatica Services PostInstallation Tasks


This chapter includes the following topics:
Informatica Services Post-Installation Tasks Overview, 55
Configure the Environment Variables, 55
Verify the System Requirements for the Domain and Application Services, 59
Verify the Setup for 32-bit and 64-bit Platforms, 59
Install the Database Client Software, 60
Verify Third Party Software Requirements, 60
Verify the Host File Configuration, 61

Informatica Services Post-Installation Tasks Overview


After you install the Informatica services, perform the post-installation tasks to ensure that the domain and
services run properly.

Configure the Environment Variables


Informatica uses environment variables to store configuration information when it runs the application services and
connects to the clients. Configure the environment variables to meet the Informatica requirements. Incorrectly
configured environment variables can cause the Informatica domain or nodes to fail to start or can cause
connection problems between the Informatica clients and the domain.
To configure environment variables on UNIX, log in with the system user account you used to install Informatica.

55

The following table describes the environment variables you configure:


Variable Type

Operating
System

Description

Informatica

Windows

Configure variables for the following Informatica properties:


- Informatica installation directory.
- Location of domains.infa.
- Informatica memory usage.

UNIX

To apply changes, restart the node.


Locale environment
variables

UNIX

Use LANG or LC_ALL to set the UNIX code page for the repository.

Library path

UNIX

Location of the database client libraries.

Informatica Environment Variables


You can configure the INFA_JAVA_OPTS, INFA_DOMAINS_FILE, and INFA_HOME environment variables to
store memory, domain, and location settings.
INFA_JAVA_OPTS
By default, Informatica uses a maximum of 512 MB of system memory.
The following table lists the minimum requirement for the maximum heap size settings, based on the number
of users and services in the domain:
Number of Domain Users

Maximum Heap Size

Maximum Heap Size

(1-5 Services)

(6-10 Services)

1,000 or less

512 MB (default)

1024 MB

5,000

2048 MB

3072 MB

10,000

3072 MB

5120 MB

20,000

5120 MB

6144 MB

30,000

5120 MB

6144 MB

Note: The maximum heap size settings in the table are based on the number of PowerCenter Repository
Services in the domain.
If the domain has more than 1,000 users, update the maximum heap size based on the number of users in the
domain.
You can use the INFA_JAVA_OPTS environment variable to configure the amount of system memory used by
Informatica. For example, to configure 1 GB of system memory for the Informatica daemon on UNIX in a C
shell, use the following command:
setenv INFA_JAVA_OPTS -Xmx1024m

On Windows, configure INFA_JAVA_OPTS as a system variable.


On 64-bit HP-UX on Itanium, add the -d64 switch.
Restart the node for the changes to take effect.

56

Chapter 5: Informatica Services Post-Installation Tasks

INFA_DOMAINS_FILE
The installer creates a domains.infa file in the Informatica installation directory. The domains.infa file contains
the connectivity information for the gateway nodes in a domain, including the domain names, domain host
names, and domain host port numbers.
Set the value of the INFA_DOMAINS_FILE variable to the path and file name of the domains.infa file.
Configure the INFA_DOMAINS_FILE variable on the machine where you install the Informatica services. On
Windows, configure INFA_DOMAINS_FILE as a system variable.
INFA_HOME
Use INFA_HOME to designate the Informatica installation directory. If you modify the Informatica directory
structure, you need to set the environment variable to the location of the Informatica installation directory or
the directory where the installed Informatica files are located.
For example, you use a softlink in UNIX for any of the Informatica directories. To configure INFA_HOME so
that any Informatica application or service can locate the other Informatica components it needs to run, set
INFA_HOME to the location of the Informatica installation directory.

Locale Environment Variables


Use LANG, LC_CTYPE, or LC_ALL to set the UNIX code page. Verify that the locale setting is compatible with the
code page for the repository. If the locale setting is not compatible with the repository code page, you cannot
create a repository service.
Different UNIX operating systems require different values for the same locale. The value for the locale variable is
case sensitive.
Use the following command to verify that the value for the locale environment variable is compatible with the
language settings for the machine and the type of code page you want to use for the repository:
locale -a

The command returns the languages installed on the UNIX operating system and the existing locale settings.
Locale on Linux
All UNIX operating systems except Linux have a unique value for each locale. Linux allows different values to
represent the same locale. For example, utf8, UTF-8, UTF8, and utf-8 represent the same locale on a
Linux machine. Informatica requires that you use a specific value for each locale on a Linux machine. Make
sure that you set the LANG environment variable appropriately for all Linux machines.
Locale for Oracle Database Clients
For Oracle database clients, set NLS_LANG to the locale you want the database client and server to use with
the login. A locale setting consists of the language, territory, and character set. The value of NLS_LANG
depends on the configuration. For example, if the value is american_america.UTF8, set the variable in a C
shell with the following command:
setenv NLS_LANG american_america.UTF8

Library Path Environment Variables


Configure library path environment variables on the machines that run the Data Integration Service processes. The
library path variable name and requirements depend on the UNIX platform and database.
Solaris and Linux
On Solaris and Linux, configure the LD_LIBRARY_PATH environment variable.

Configure the Environment Variables

57

The following table describes the values that you set for the LD_LIBRARY_PATH for the different databases:
Database

Value

Oracle

<DatabasePath>/lib

IBM DB2

<DatabasePath>/lib

Sybase ASE

${SYBASE_OCS}/lib:${SYBASE_ASE}/lib:${LD_LIBRARY_PATH}

Informix

<DatabasePath>/lib

Teradata

<DatabasePath>/lib

ODBC

<CLOSEDODBCHOME>/lib

AIX
On AIX, configure the LIBPATH environment variable.
The following table describes the values that you set for the LIBPATH for the different databases:
Database

Value

Oracle

<DatabasePath>/lib

IBM DB2

<DatabasePath>/lib

Sybase ASE

${SYBASE_OCS}/lib:${SYBASE_ASE}/lib:${LIBPATH}

Informix

<DatabasePath>/lib

Teradata

<DatabasePath>/lib

ODBC

<CLOSEDODBCHOME>/lib

HP-UX
On HP-UX, configure the SHLIB_PATH environment variable.
The following table describes the values that you set for the SHLIB_PATH for the different databases:

58

Database

Value

Oracle

<DatabasePath>/lib

IBM DB2

<DatabasePath>/lib

Sybase ASE

"${SYBASE_OCS}/lib:${SYBASE_ASE}/lib:${SHLIBPATH}"

Informix

<DatabasePath>/lib

Teradata

<DatabasePath>/lib

ODBC

<CLOSEDODBCHOME>/lib

Chapter 5: Informatica Services Post-Installation Tasks

Verify the System Requirements for the Domain and


Application Services
You can create an Informatica domain with one node and run all application services on the same node. If you
create an Informatica domain with multiple nodes, you can run the application services on separate nodes.
The following table lists the minimum system requirements for a domain with different node configurations:
Component

Processor

RAM

Disk Space

Domain with all Data Quality, Data Services, and


PowerCenter services running on one node

4 CPU

10GB

12 GB

Domain with Data Quality and Data Services


application services running on one node:
- Data Integration Service
- Model Repository Service
- Analyst Service
- Content Management Service
- Data Director Service

4 CPU

8 GB

12 GB

For more information about product requirements and supported platforms, see the Product Availability Matrix on
the Informatica Customer Portal: https://communities.informatica.com/community/my-support/tools/productavailability-matrices

Verify the Setup for 32-bit and 64-bit Platforms


You can run Data Quality on 32-bit or 64-bit platforms. A 64-bit architecture provides larger memory space that
can significantly reduce or eliminate disk input and output and, in turn, potentially increase session performance in
the following areas:
Caching. With a 64-bit platform, the Data 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.


The Informatica 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.
When you run Informatica on both 32-bit and 64-bit platforms, configure the correct libraries, database clients, and
session cache sizes.
Use the following guidelines when you work with 32-bit and 64-bit platforms:
Libraries. Link libraries according to the following guidelines:
- Link 32-bit applications with 32-bit libraries. Link 64-bit applications with 64-bit libraries.
- Link 32-bit machines running a Data Integration Service with a 32-bit database client. Link a 64-bit machine

running a Data Integration Service with 64-bit database client.


Database clients. Link a 32-bit machine running a Model Repository Service with 32-bit database clients. Link

a 64-bit machine running a Model Repository Service with 64-bit database clients.

Verify the System Requirements for the Domain and Application Services

59

Data Integration Service and Model Repository Service. 32-bit and 64-bit machines that run Data

Integration Services and Model Repository Services are compatible with each other.

Install the Database Client Software


Based on the types of databases that the Data Integration Service will access, install the following database
clients and configure connectivity on the machine where the Data Integration Service runs:
Oracle client
IBM DB2 Client Application Enabler (CAE)
Microsoft SQL Client, with Microsoft OLE DB provider for Microsoft SQL Server
Sybase Open Client (OCS)
Teradata BTEQ client

Database Client Environment Variables


Configure database client environment variables on the machines that run the Data Integration Service. The
database client path variable name and requirements depend on the UNIX platform and repository database.
After you configure the database environment variables, you can test the connection to the database from the
database client.
The following table describes the database environment variables you need to set on UNIX:
Database

Environment Variable
Name

Database
Utility

Value

Oracle

ORACLE_HOME

sqlplus

Set to: <DatabasePath>

PATH
IBM DB2

Sybase ASE

Teradata

DB2DIR

Add: <DatabasePath>/bin
db2connect

Set to: <DatabasePath>

DB2INSTANCE

Set to: <DB2InstanceName>

PATH

Add: <DatabasePath>/bin

SYBASE12 or SYBASE15

isql

Set to: <DatabasePath>/sybase<version>

SYBASE_ASE

Set to: ${SYBASE[12 | 15]}/ASE-<version>

SYBASE_OCS

Set to: ${SYBASE[12 | 15]}/OCS-<version>

PATH

Add: ${SYBASE_ASE}/bin:${SYBASE_OCS}/bin:$PATH

PATH

bteq

Add: <DatabasePath>/bin

Verify Third Party Software Requirements


Informatica requires third party software and libraries to perform certain operations. Verify that the machine where
you install Informatica has the required software or library.

60

Chapter 5: Informatica Services Post-Installation Tasks

Informatica Administrator
Informatica Administrator requires the following third party software to run:
Adobe Flash Player Plug-In
Informatica Administrator contains the Dependency Graph window, which requires the Adobe Flash Player
plug-in version 10 or later. To view dependencies for application services and nodes in Informatica
Administrator, download and install the Flash Player plug-in on the web browser. Get the Flash Player plug-in
from the following web site:
http://www.adobe.com/products/flashplayer/

SAP Java Connector 3.0


The Developer tool requires the SAP Java Connector 3.0 (SAP JCo 3.0) library files to work with SAP connections
and data objects. SAP JCo 3.0 is also required when you install ABAP programs.
If you plan to use SAP connections and data objects in the Developer tool, download SAP JCo 3.0 files from the
SAP Service Marketplace:
http://service.sap.com/connectors
If you have problems downloading SAP JCo 3.0 from the SAP web site, contact Informatica Global Customer
Support.
Download SAP JCo 3.0 to the machine that hosts the Developer tool. Extract the SAP JCo 3.0 files and copy the
files to the Developer tool directory:
File

Directory

sapjco3.jar

<InformaticaInstallationDir>\clients\DeveloperClient\plugins
\com.informatica.tools.adapters.ics.sap.table_1.0.0\lib
Note: Change the name of the sapjco3.jar file to sapjco.jar.

sapjco3.dll

<InformaticaInstallationDir>\clients\DeveloperClient\bin

If you do not download and install SAP JCo 3.0, the Developer tool displays the following error message when you
create SAP connections and data objects or install ABAP programs:
SAPJCo library files might not be installed. Install the SAPJCo library files and try again.

Verify the Host File Configuration


Verify that host file on the node that runs the Data Integration Service contains a localhost entry. Otherwise,
mappings might fail when the Data Integration Service Launch Jobs as Separate Processes property is enabled.
When you create the Data Integration Service, the Launch Jobs as Separate Processes property is enabled by
default.

Verify the Host File Configuration

61

CHAPTER 6

Starting Informatica Services


This chapter includes the following topics:
Starting Informatica Services Overview, 62
Starting and Stopping Informatica, 62
Logging in to Informatica Administrator, 64
Configuring the Informatica Windows Service, 65
Getting Started with the Data Quality Services, 66
Configure the Data Quality Modules on the Data Integration Service, 67
Configure Reference Data Properties, 67
Set Privileges on Reference Table Data, 68

Starting Informatica Services Overview


On each node where you install Informatica, the installer creates a Windows service or UNIX daemon to run
Informatica. When the installation completes successfully, the installer starts the Informatica service on Windows
or the Informatica daemon on UNIX.
You can configure the behavior of the Informatica Windows service.
The Informatica service runs the Service Manager on the node. The Service Manager runs the application services
on the node. The method you use to start or stop Informatica depends on the operating system. You can use
Informatica Administrator to shut down a node. When you shut down a node, you stop Informatica on the node.
The Informatica service also runs Informatica Administrator. You use Informatica Administrator to administer the
Informatica domain objects and user accounts. Log in to Informatica Administrator to create the user accounts for
users of Informatica and to create and configure the application services in the domain.

Starting and Stopping Informatica


On UNIX, use a command line program to start or stop the Informatica daemon. On Windows, you can start or
stop the Informatica service from the Control Panel or the Start menu.

62

Starting and Stopping Informatica on UNIX


On UNIX, run infaservice.sh to start and stop the Informatica daemon. By default, infaservice.sh is installed in the
following directory:
<InformaticaInstallationDir>/tomcat/bin

1.

Go to the directory where infaservice.sh is located.

2.

At the command prompt, enter the following command to start the daemon:
infaservice.sh startup

Enter the following command to stop the daemon:


infaservice.sh shutdown

Note: If you use a softlink to specify the location of infaservice.sh, set the INFA_HOME environment variable
to the location of the Informatica installation directory.

Starting and Stopping Informatica on Windows


You can use the Services window in the Control Panel or the Start menu shortcut to start or stop the Informatica
services.

Starting or Stopping Informatica from the Start Menu


To start Informatica from the Windows Start menu, click Programs > Informatica[Version] > Server > Start
Informatica Services.
To stop Informatica from the Windows Start menu, click Programs > Informatica[Version] > Server > Stop
Informatica Services.
After you start the Windows service, configure the firewall to allow client machines to access the Service Manager
in the domain.

Starting or Stopping Informatica from the Control Panel


The procedure to start or stop the Informatica Windows service is the same as for all other Windows services.
1.

Open the Windows Control Panel.

2.

Select Administrative Tools.

3.

Select Services.

4.

Right-click the Informatica service.

5.

If the service is running, click Stop.


If the service is stopped, click Start.

After you start the Windows service, configure the firewall to allow client machines to access the Service Manager
in the domain.

Configuring the Windows Firewall


When you start the Informatica Windows service, the machines where you install the Informatica clients cannot
access the Service Manager in the Informatica domain. To allow the clients access to the Service Manager, you
must configure the firewall to grant client machines access to the domain.
On the machine where you created the Informatica domain, add the client machines to the list of firewall
exceptions.
1.

On the Windows Control Panel, open Windows Firewall.

Starting and Stopping Informatica

63

2.

On the Windows Firewall window, click the Exceptions tab.

3.

Click Add Program.

4.

On the Add a Program window, click Browse.


The infasvcs.exe file runs the Service Manager in the domain.

5.

Go to the following directory in the Informatica installation directory:


<InformaticaInstallationDir>\tomcat\bin

6.

Select infasvcs.exe and click Open.


The infasvcs.exe file appears in the list of programs.
You can click Change Scope to specify the machines that you want to access Informatica.

7.

Verify that the infasvcs.exe file appears in the list of programs and services and that it is enabled.

8.

Click OK.

Stopping Informatica in Informatica Administrator


When you shut down a node using Informatica Administrator, you stop the Informatica service on that node. You
can abort the processes that are running or allow them to complete before the service shuts down. If you shut
down a node and abort repository service processes running on the node, you can lose changes that have not yet
been written to the repository. If you abort a node running integration service processes, the workflows will abort.
1.

Log in to Informatica Administrator.

2.

In the Navigator, select the node to shut down.

3.

On the Domain tab Actions menu, select Shutdown Node.

Rules and Guidelines for Starting or Stopping Informatica


Use the following rules and guidelines when starting and stopping Informatica 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, verify that the port used by the service on the node is available. For example, if

you stop Informatica on a node, verify that the port is not used by any other process on the machine before you
restart Informatica. If the port is not available, Informatica will fail to start.
If you do not use Informatica Administrator 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 Informatica
Administrator.
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, start Informatica 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.

Logging in to Informatica Administrator


You must have a user account to log in to Informatica Administrator.
1.

64

Start a Microsoft Internet Explorer or Mozilla Firefox browser.

Chapter 6: Starting Informatica Services

2.

In the Address field, enter the URL for Informatica Administrator:


http://<host>:<port>/administrator

Host and port in the URL represent the host name of the master gateway node and the port number for
Informatica Administrator. If you configure Informatica Administrator to use HTTPS, the URL redirects to the
HTTPS site:
https://<host>:<https port>/administrator

3.

On the login page, enter the user name and password.

4.

Select Native or the name of a specific security domain.


The Security Domain field appears when the Informatica domain contains an LDAP security domain. If you
do not know the security domain that your user account belongs to, contact the Informatica domain
administrator.

5.

Click Login.

6.

If this is the first time you log in with the user name and password provided by the domain administrator,
change your password to maintain security.

Configuring the Informatica Windows Service


You can configure the behavior of the Informatica Windows service when the operating system starts or when the
service fails.You can also configure the user account that logs in to the service.
Use the following rules and guidelines when you configure the user account that logs in to the service:
If you store files on a network drive, use a system account instead of the Local System account to run the

Informatica service.
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 the Informatica service must have access to the shared
location.
If you want to use the Local System account, verify that the user starting the Informatica service has access to

the network location.


If the user that starts the Informatica service cannot access the shared storage location, service processes on

the node fail or the node or domain will not start.


If you configure a system user account, the user account must have the Act as operating system permission.

For more information, see the Windows documentation.


To configure the Informatica Windows service:
1.

Open the Windows Control Panel.

2.

Select Administrative Tools.

3.

Select Services.

4.

Double-click Informatica <Version>.


The Informatica <Version> Properties dialog box appears.

5.

Click the Log On tab.

6.

Select This account.

7.

Enter the domain and user name or click Browse to locate a system user.

8.

Enter and confirm the password for the selected user account.

9.

Click the Recovery tab. Select the options to restart the Informatica service if the service fails.

Configuring the Informatica Windows Service

65

For more information about configuring system accounts for services and service restart options on Windows, see
the Windows documentation.

Getting Started with the Data Quality Services


After you install and configure Informatica, you can start the Data Quality application services.
1.

Start Informatica.

2.

Log in to Informatica Administrator to create and manage the Informatica application services and
components. After you create a service, enable it before you create the next one.

3.

Create the following application services:


Model Repository Service
The Model Repository Service manages the Model repository. The Model repository stores metadata
created by Informatica products in a relational database to enable collaboration among the products.
Informatica Developer, Informatica Analyst, Data Integration Service, and the Administrator tool store
metadata in the Model repository.
When you create the Model Repository Service, specify the database in which to create the Model
repository.
Data Integration Service
The Data Integration Service is an application service in the Informatica domain that performs data
integration tasks for the Analyst tool, the Developer tool, and external clients. When you preview or run
mappings, profiles, SQL data services, and web services in Informatica Analyst or Informatica Developer,
the application sends requests to the Data Integration Service to perform the data integration tasks.
When you start a command from the command line or an external client to run mappings, SQL data
services, web services, and workflows in an application, the command sends the request to the Data
Integration Service.
When you create the Data Integration Service, you must associate it with a Model Repository Service.
You also configure the profiling warehouse database and the Human Task Service database on the Data
Integration Service.
Analyst Service
The Analyst Service is an application service that runs Informatica Analyst in the Informatica domain. The
Analyst Service manages the connections between service components and the users that have access
to the Analyst tool.
When you create the Analyst Service, specify the Model Repository Service and Data Integration Service
to associate with it. You must also specify a staging database and a flat file cache location.
Content Management Service
The Content Management Service manages configuration options for reference data, address validation
data, identity populations, classifier models, and probabilistic models. The service provides reference
data, address validation port lists, identity population file information, and classifier and probabilistic
model information to the Developer tool. The service provides reference data information to the Analyst
Tool.
Data Director Service
The Data Director Service is an application service that runs the Informatica Data Director for Data
Quality web application in the Informatica domain.

66

Chapter 6: Starting Informatica Services

4.

To use the JasperReports application, create a Reporting and Dashboards Service.

5.

Start the Developer tool.

6.

Launch a browser and log in to the Analyst tool.

Configure the Data Quality Modules on the Data


Integration Service
You use a wizard to create a Data Integration Service in the Administrator tool. The wizard includes a step to
create Human Task Service and Profiling Service modules on the Data Integration Service. The wizard creates the
modules by default.
After you create a Data Integration Service, configure the following properties for the Human Task Service module
and Profiling Service module:
Human task service properties
Configure the Human Task Service properties to identify the database that stores Human task configuration
data.
Profiling warehouse database properties
Configure the profiling warehouse database properties to identify the database that stores profile data and
verify the database settings.
Advanced profiling properties
Configure the advanced profiling properties to set additional options for the profiling warehouse database.
Workflow service properties
Configure the Workflow Service properties to identify the Data Integration Service that runs Human tasks in a
workflow. You can specify any Data Integration Service on the domain.
When the current Data Integration Service runs a workflow that contains a Human task, the Data Integration
Service specified in the Workflow Service property processes the Human task data.
Stop the Data Integration Service before you configure the properties.

Configure Reference Data Properties


Configure the Content Management Service for the reference data that you want to use.
Use the Content Management Service options to specify properties for the following types of data:
Address validation reference data
Configure the address validation properties to determine how the Data Integration Service and the Developer
tool read address reference data files.
Classifier model and probabilistic model data
Configure the natural language processing (NLP) properties to set the locations of the probabilistic model and
classifier model data files.

Configure the Data Quality Modules on the Data Integration Service

67

Identity population data


Configure the identity properties to set the locations of the identity population files and other files used in
identity match analysis.
Reference table data
Configure the reference data location properties to identify the database that stores reference table data
values.
You also use the properties to identify the Data Integration Service and the Model Repository Service that are
associated with the Content Management Service.

Set Privileges on Reference Table Data


Use the Security options in the Administrator tool to assign reference table data privileges to users and groups.
You assign the privileges on the Content Management Service.
You can assign the following privileges:
Create reference table data
Edit reference table data

68

Chapter 6: Starting Informatica Services

CHAPTER 7

Informatica Clients Pre-Installation


Tasks
This chapter includes the following topics:
Informatica Clients Pre-Installation Tasks Overview, 69
Verify System User Account, 70

Informatica Clients Pre-Installation Tasks Overview


Before you install the Informatica clients on Windows, verify that the minimum system and third party software
requirements are met. If the machine where you install the Informatica clients is not configured correctly, the
installation can fail.

Verify the Minimum System Requirements


You can install all Informatica client tools on the same machine or on separate machines. You can also install the
clients on multiple machines. The requirements for the Informatica clients depend on the client tool you install.
The following table lists the minimum system requirements to run Informatica Developer:
Client

Processor

RAM

Disk Space

Informatica Developer

1 CPU

512 MB

2.5 GB

Data Transformation Studio

1 CPU

512 MB

708 MB

Temporary Disk Space Requirements for Installation


The installer writes temporary files to the hard disk. Verify that you have enough available disk space on the
machine to support the installation. When the installation completes, the installer deletes the temporary files and
releases the disk space.

69

The following table lists the temporary disk space requirements during installation:
Product

Disk Space

Installer

1 GB

Informatica Clients

550 MB

Verify the Third Party Software Required by the Informatica


Developer Tools
The following table lists the third party software requirements for the Informatica Developer tools:
Client

Third Party Software

Data Transformation Studio

Eclipse

Verify the Third Party Software Required by Data Transformation Studio


If you are installing Data Transformation Studio on an existing Eclipse installation, verify that you have Eclipse
version 3.2.2. or 3.3 installed.

Verify System User Account


Verify that the user account that you use to install the Informatica clients has write permission on the installation
directory and Windows registry.

70

Chapter 7: Informatica Clients Pre-Installation Tasks

CHAPTER 8

Informatica Clients Installation


This chapter includes the following topics:
Informatica Clients Installation Overview, 71
Installing in Graphical Mode, 71
Installing in Silent Mode, 72

Informatica Clients Installation Overview


You can install the Informatica clients on Windows in graphical or silent mode.
Complete the pre-installation tasks to prepare for the installation. You can install the Informatica clients on multiple
machines.

Installing in Graphical Mode


You can install the Informatica clients in graphical mode on Windows.
1.

Close all other applications.

2.

Run install.bat from the root directory.


If you encounter problems when you run the install.bat file from the root directory, run the following file:
<InformaticaInstallationDir>/client/install.exe

3.

Select Install Informatica 9.5.1 Clients and click Next.


The Installation Pre-requisites page displays the system requirements. Verify that all installation
requirements are met before you continue the installation.

4.

Click Next.
On the Application Client Selection page, select the Informatica clients you want to install.
You can install the following Informatica client applications on the same machine:
Informatica Developer
PowerCenter Client
Data Transformation Studio

You can install multiple clients at the same time.


If you install Informatica Developer, you must also install Data Transformation Studio.

71

5.

On the Installation Directory page, enter the absolute path for the installation directory.
The installation directory must be on the current computer. The directory names in the path must not contain
spaces or the dollar sign ($). The maximum length of the path must be less than 260 characters.
If you are installing Data Transformation Studio, the Data Transformation Studio Configuration page
appears.
If you are not installing Data Transformation Studio, the Pre-Installation Summary page appears.

6.

Click Next.

7.

If you are installing Data Transformation Studio, select the Eclipse installation option for Data Transformation
Studio, and then click Next.

8.

On the Pre-Installation Summary page, review the installation information, and click Install.
The installer copies the Informatica client files to the installation directory.
The Post-installation Summary page indicates whether the installation completed successfully.

9.

Click Done.

You can view the installation log files to get more information about the tasks performed by the installer.

Installing in Silent Mode


To install the Informatica clients without user interaction, install in silent mode.
Use a properties file to specify the installation options. The installer reads the file to determine the installation
options. You can use silent mode installation to install the Informatica clients on multiple machines on the network
or to standardize the installation across machines.
To install in silent mode, complete the following tasks:
1.

Configure the installation properties file and specify the installation options in the properties file.

2.

Run the installer with the installation properties file.

Configuring the Properties File


Informatica provides a sample properties file that includes the properties required by the installer. Customize the
sample properties file to create a properties file and specify the options for your installation. Then run the silent
installation.
The sample SilentInput.properties file is stored in the root directory of the DVD or the installer download location.
1.

Go to the root of the directory that contains the installation files.

2.

Locate the sample SilentInput.properties file.

3.

Create a backup copy of the SilentInput.properties file.

4.

Use a text editor to open and modify the values of the properties in the file.
The following table describes the installation properties that you can modify:

72

Property Name

Description

INSTALL_TYPE

Indicates whether to install or upgrade the Informatica clients.

Chapter 8: Informatica Clients Installation

Property Name

Description
If the value is 0, the Informatica clients are installed in the directory you specify. If the
value is 1, the Informatica clients are upgraded.
Default is 0.

UPG_BACKUP_DIR

Directory of the previous version of the Informatica client that you want to upgrade.

USER_INSTALL_DIR

Informatica client installation directory.

DXT_COMP

Indicates whether to install Informatica Developer.


If the value is 1, the Developer tool will be installed. If the value is 0, the Developer
tool will not be installed.
Default is 1.

CLIENT_COMP

Indicates whether to install PowerCenter Client.


If the value is 1, PowerCenter Client will be installed. If the value is 0, PowerCenter
Client will not be installed.
Default is 1.

DT_COMP

Indicates whether to install Data Transformation Studio.


If the value is 1, Data Transformation Studio will be installed. If the value is 0, Data
Transformation Studio will not be installed.
If DXT_COMP=1, set this paramter to 1.

NEW_ECLIPSE_SELECTION

You can set this parameter if DT_COMP=1. Indicates whether to install the copy of
Eclipse that is bundled with the installer or use an Eclipse development environment
that is already installed on your machine.
If the value is 0, the installer uses the Eclipse development environment that is already
installed on your machine. Set the ECLIPSE_LOCATION property. If the value is 1, the
setup installs the copy of Eclipse that is bundled with the installer. Default is 1.

ECLIPSE_LOCATION

Required if NEW_ECLIPSE_SELECTION=0.
Absolute path of the existing eclipse.exe file.

5.

Save the properties file.

Sample Properties File


The following example shows the contents of the sample SilentInput.properties file:
##########################################################
# Informatica Installer Build Details
# Copyright (c) Informatica Corporation 1998 - 2012
# This software contains confidential and proprietary
# information of Informatica Corporation.
# All Rights Reserved.
##########################################################
#######
# Use this file (SilentInput.properties) to install or upgrade the Informatica clients without user
interaction.
#
Use this sample properties file to define the parameters for the silent installation or upgrade.
# Use the following guidelines when you edit this file:
#
Back up the file before you modify it.
#
Any error condition that causes the installation or upgrade to fail, such as an installation
directory that is not valid, #
generates a log file in SYSTEM_DRIVE_ROOT. For example: c:
\silentErrorLog.log
#######

Installing in Silent Mode

73

# The INSTALL_TYPE property determines whether to install or upgrade Informatica.


#
Value
0
Perform a new installation of Informatica.
#
Value
1
Upgrade a previous version of Informatica.
INSTALL_TYPE=0
# The USER_INSTALL_DIR property represents the directory in which to install the new version of
Informatica.
#
Set the property if you are installing or upgrading Informatica.
#
The property must point to a valid directory with write permissions enabled.
USER_INSTALL_DIR=c:\Informatica\9.5.1
# The UPG_BACKUP_DIR property represents the directory that contains the PowerCenter or Informatica
version that you want to upgrade.
#
Set the property if you are upgrading Informatica.
#
This property must point to a valid PowerCenter or Informatica client installation.
UPG_BACKUP_DIR=c:\Informatica\9.5.0
# The DXT_COMP property determines whether to install Informatica Developer.
#
Set the property if you are installing or upgrading Informatica.
#
Value
1
Install Informatica Developer.
#
Value
0
Do not install Informatica Developer.
DXT_COMP=1
# The CLIENT_COMP property determines whether to install the PowerCenter Client.
#
Set the property if you are installing or upgrading Informatica.
#
Value
1
Install the PowerCenter Client.
#
Value
0
Do not install the PowerCenter Client.
CLIENT_COMP=1
# The DT_COMP property determines whether to install the Data Transformation Studio.
#
Set the property if you are installing or upgrading Informatica.
#
If DXT_COMP=1, set the property to 1.
#
Value
1
Install Data Transformation Studio.
#
Value
0
Do not install Data Transformation Studio.
DT_COMP=1
# The NEW_ECLIPSE_SELECTION property determines whether to install the copy of Eclipse that is bundled
with the installer or
#
use an Eclipse development environment that is already installed on your machine.
#
Set the property if DT_COMP=1.
#
Value
0
Install Data Transformation Studio to use the Eclipse development environment that
is already installed on your machine.
#
Value
1
Install Data Transformation Studio to use the copy of Eclipse that is bundled with
the installer.
NEW_ECLIPSE_SELECTION=1
# The ECLIPSE_LOCATION property represents the directory that contains the existing eclipse.exe file.
#
Set the property to the existing Eclipse location if "NEW_ECLIPSE_SELECTION=0".
#
Do not set the property if NEW_ECLIPSE_SELECTION=1.
ECLIPSE_LOCATION=
#######
# After you create the properties file, save the file with the name SilentInput.properties and
#
run the silent installer to perform the Informatica client installation.
#######

74

Chapter 8: Informatica Clients Installation

Running the Installer


After you configure the properties file, open a command window to start the silent installation.
1.

Open a command window.

2.

Go to the root of the directory that contains the installation files.

3.

Verify that the directory contains the file SilentInput.properties that you edited and resaved.

4.

To run the silent installation, double-click the file silentInstall.bat.

The silent installer runs in the background. The process can take a while. The silent installation is complete when
the Informatica_<Version>_Client_InstallLog.log file is created in the installation directory.
The silent installation fails if you incorrectly configure the properties file or if the installation directory is not
accessible. View the installation log files and correct the errors. Then run the silent installation again.

Installing in Silent Mode

75

CHAPTER 9

Informatica Clients Post-Installation


Tasks
This chapter includes the following topics:
Informatica Clients Post-Installation Tasks Overview, 76
Verify that a Graphics Display Server is Available, 76
Configure the Web Browser, 77
Install the Languages for the Client Tools, 77
Configure the Workspace Directory, 78

Informatica Clients Post-Installation Tasks Overview


After you install the Informatica clients, perform the post-installation tasks to ensure that the clients run properly.

Verify that a Graphics Display Server is Available


The gateway nodes on UNIX require a graphics display server to run domain reports in Informatica Administrator.
If you do not have a graphics display server, you can install and configure X Virtual Frame Buffer (Xvfb). Xvfb is an
X server that renders graphics to virtual memory rather than to a graphics display device.
You can download and install Xvfb for the following operating systems:
HP-UX. Xvfb is part of the HP-UX operating system. Install HP-UX patches and graphical packages to run Xvfb

based on when you installed or last patched the operating system. For instructions to run Xvfb on HP-UX, see
the following web site:
http://publib.boulder.ibm.com/tividd/td/ITM/GI10-5797-01/en_US/HTML/notesmst20.htm
AIX and Linux. Download and install Xvfb. For instructions to run Xvfb on AIX and Linux, see the following web

site:
http://publib.boulder.ibm.com/infocenter/iwphelp/v2r5m1/index.jsp?topic=/com.ibm.wcs.ic.doc_2.5.1/
install/i_inst_t_lwpsetup_xfvb_on_unx.html
Solaris. You can download Xvfb for Solaris from the following web site:
http://ferret.pmel.noaa.gov/FERRET_17sep07/FAQ/graphics/Solaris_Xvfb.html

76

Download and set up Xvfb for Solaris. Use the following command to start the virtual frame buffer and send
graphics outputs going to display 1 to shared memory:
% /usr/X11R6/bin/Xvfb :1 -screen 0 1152x900x8 &

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

Configure the Web Browser


You can use Microsoft Internet Explorer or Mozilla Firefox to launch the web client applications in the Informatica
platform.
The following table describes the browser you can use with the web applications:
Component

Web Browser

Informatica Administrator

Microsoft Internet Explorer, Mozilla Firefox

Reporting and Dashboards


Service

Microsoft Internet Explorer, Mozilla Firefox

Informatica Analyst

Microsoft Internet Explorer, Mozilla Firefox

Configure the following options in the browser to access the applications:


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. To configure the
controls, click Tools > Internet Options > Security > Custom level.
Javascript. Enable Javascript to use Firefox.
TLS 1.0. If you configure HTTPS for Informatica Administrator on a domain that runs on 64-bit AIX, Internet

Explorer requires TLS 1.0. To enable TLS 1.0, click Tools > Internet Options > Advanced. The TLS 1.0 setting
is listed below the Security heading.

Install the Languages for the Client Tools


If you need to view languages other than the system locale and you work with repositories that use a UTF-8 code
page, install additional languages on Windows for use with the Informatica clients. You also must install languages
to use the Windows Input Method Editor (IME).
To install languages:
1.

Click Start > Settings > Control Panel.

2.

Click Regional Options.

3.

Under Language settings for the system, select the languages you want to install.

4.

Click Apply.

Windows might require you to restart the system.

Configure the Web Browser

77

Configure the Workspace Directory


Configure Informatica Developer to write the workspace metadata to the machine from which the user is logged.
1.

Go to the following directory: <InformaticaInstallationDir>\clients\DeveloperClient\configuration\

2.

Locate the config.ini file.

3.

Create a backup copy of the config.ini file.

4.

Use a text editor to open the config.ini file.

5.

Add the osgi.instance.area.default variable to the end of the config.ini file and set the variable to the
directory location where you want to save the workspace metadata. The file path cannot contain non-ANSI
characters. Folder names in the workspace directory cannot contain the number sign (#) character. If folder
names in the workspace directory contain spaces, enclose the full directory in double quotes.
If you run Informatica Developer from the local machine, set the variable to the absolute path of the

workspace directory:
osgi.instance.area.default=<Drive>/<WorkspaceDirectory>

or
osgi.instance.area.default=<Drive>\\<WorkspaceDirectory>
If you run Informatica Developer from a remote machine, set the variable to the directory location on the

local machine:
osgi.instance.area.default=\\\\<LocalMachine>/<WorkspaceDirectory>

or
osgi.instance.area.default=\\\\<LocalMachine>\\<WorkspaceDirectory>

The user must have write permission to the local workspace directory.
Informatica Developer writes the workspace metadata to the workspace directory. If you log into Informatica
Developer from a local machine, Informatica Developer writes the workspace metadata to the local machine. If the
workspace directory does not exist on the machine from which you logged in, Informatica Developer creates the
directory when it writes the files.
You can override the workspace directory when you start Informatica Developer.

78

Chapter 9: Informatica Clients Post-Installation Tasks

CHAPTER 10

Starting Informatica Clients


This chapter includes the following topics:
Starting the Developer Tool, 79
Logging In to the Analyst Tool, 80

Starting the Developer Tool


When you start the Developer tool, you connect to a Model repository. The Model repository stores metadata
created in the Developer tool. The Model Repository Service manages the Model repository. Connect to the
repository before you create a project.
1.

From the Windows Start menu, click Programs > Informatica[Version] > Client > Developer Client >
Launch Informatica Developer.
The first time you run the Developer tool, the Welcome page displays several icons. The Welcome page does
not appear when you run the Developer tool subsequently.

2.

Click Workbench.
The first time you start the Developer tool, you must select the repository in which to save the objects you
create.

3.

Click File > Connect to Repository.


The Connect to Repository dialog box appears.

4.

If you have not configured a domain in the Developer tool, click Configure Domains to configure a domain.
You must configure a domain to access a Model Repository Service.

5.

Click Add to add a domain.


The New Domain dialog box appears.

6.

Enter the domain name, host name, and port number.

7.

Click Finish.

8.

Click OK.

9.

In the Connect to Repository dialog box, click Browse and select the Model Repository Service.

10.

Click OK.

11.

Click Next.

12.

Enter a user name and password.

79

13.

Click Finish.
The Developer tool adds the Model repository to the Object Explorer view. When you run the Developer tool
the next time, you can connect to the same repository.

Logging In to the Analyst Tool


The Analyst Service runs the the Analyst tool web client. You must create an Analyst Service in Informatica
Administrator before you start the Analyst tool.
1.

Start a Microsoft Internet Explorer or Mozilla Firefox browser

2.

In the Address field, enter the URL for the Analyst tool:
http://<host>:<port>/AnalystTool

3.

On the login page, enter the user name and password.

4.

Select Native or the name of a specific security domain.


The Security Domain field appears when the Informatica domain contains an LDAP security domain. If you
do not know the security domain that your user account belongs to, contact the Informatica domain
administrator.

5.

Click Login.

You can also use the Service URL link for the Analyst Service to start the the Analyst tool web client from
Informatica Administrator.

80

Chapter 10: Starting Informatica Clients

CHAPTER 11

Troubleshooting the Informatica


Installation
This chapter includes the following topics:
Installation Troubleshooting Overview, 81
Installation Log Files, 81
Troubleshooting Domains and Nodes, 83
Troubleshooting Data Transformation Server, 85

Installation Troubleshooting Overview


This chapter provides information about the Informatica installation process and the cause and resolution of errors
that occur during installation. The examples included in this chapter describe general troubleshooting strategies
and are not a comprehensive list of possible causes of installation issues.

Installation Log Files


You can use the following log files to troubleshoot an Informatica installation:
Installation log files. The installer produces log files during and after the installation. You can use these logs

to get more information about the tasks completed by the installer and errors that occurred during installation.
The installation log files include the following logs:
- Debug logs
- File installation logs
Service Manager log files. Log files generated when the Service Manager starts on a node.

Debug Log Files


The installer writes actions and errors to the debug log file. The name of the log file depends on the Informatica
component you install.

81

The following table describes the properties of the debug log files:
Property

Description

Log File Name

Location

Installation directory.

Usage

Get more information about the actions performed by the installer and get more information about
installation errors. The installer writes information to this file during the installation. If the installer
generates an error, you can use this log to troubleshoot the error.

Contents

Detailed summary of each action performed by the installer, the information you entered in the installer,
each command line command used by the installer, and the error code returned by the command.

Informatica_<Version>_Services.log
Informatica_<Version>_Client.log
Informatica_<Version>_Services_Upgrade.log
Informatica_<Version>_Client_Upgrade.log

The debug log contains output from the infacmd and infasetup commands used to create the domain, node, and
application services. It also contains information about starting the application services.

File Installation Log File


The file installation log file contains information about the installed files.
The following table describes the properties of the installation log file:
Property

Description

Log File Name

- Informatica_<Version>_Services_InstallLog.log
- Informatica_<Version>_Client_InstallLog.log

Location

Installation directory.

Usage

Get information about the files installed and registry entries created.

Contents

Directories created, names of the files installed and commands run, and status for each installed file.

Service Manager Log Files


The installer starts the Informatica service. The Informatica service starts the Service Manager for the node. The
Service Manager generates log files that indicate the startup status of a node. Use these files to troubleshoot
issues when the Informatica service fails to start and you cannot log in to Informatica Administrator. The Service
Manager log files are created on each node.
The following table describes the files generated by the Service Manager:

82

Property

Description

catalina.out

Log events from the Java Virtual Machine (JVM) that runs the Service Manager. For example, a
port is available during installation, but is in use when the Service Manager starts. Use this log to

Chapter 11: Troubleshooting the Informatica Installation

Property

Description
get more information about which port was unavailable during startup of the Service Manager. The
catalina.out file is in the /tomcat/logs directory.

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. The node.log file is in the /tomcat/logs directory.

Note: The Service Manager also uses node.log to record events when the Log Manager is unavailable. For
example, if the machine where the Service Manager runs does not have enough available disk space to write log
event files, the Log Manager is unavailable.

Troubleshooting Domains and Nodes


The installer can generate errors when creating and configuring domains and nodes during the Informatica
installation.
You can encounter errors with the following installer tasks:
Adding the domain configuration database
Creating or joining a domain
Starting Informatica
Pinging the domain
Adding a license

Creating the Domain Configuration Repository


If you create a domain, the installer creates a domain configuration repository to store domain metadata. The
installer uses the options you enter during installation to add configuration metadata to the domain configuration
repository. The installer uses JDBC to communicate with the database. You do not need to configure ODBC or
native connectivity on the machine where you install the Informatica services.
The installer creates and drops a table in the domain configuration repository database to verify the connection
information. The user account for the database must have create privileges on the database. Each domain must
have a separate domain configuration repository.

Creating or Joining a Domain


The installer completes different tasks depending on whether you create a domain or join a domain:
Creating 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.
Joining 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 window to run the commands.

Troubleshooting Domains and Nodes

83

The infasetup and infacmd commands fail if the gateway node is unavailable. If the gateway node is unavailable,
you cannot log in to Informatica Administrator.
For example, the DefineDomain command fails if you click Test Connection and the connection test passes but the
database becomes unavailable before you click Next. The DefineDomain command can 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 the Informatica service is running on the gateway node and try
again.

Starting Informatica
The installer runs infaservice to start the Informatica service. To troubleshoot issues when Informatica fails to
start, use the information in the installation debug log and the node.log and catalina.out Service Manager log files
to identify the cause of the error.
If you create a domain, log in to Informatica Administrator after the Informatica service starts to verify that the
domain is available. If you join a domain, log in to Informatica Administrator after the Informatica service starts to
verify that the node was successfully created and started.
Informatica can fail to start for the following reasons:
The Service Manager is out of system memory. The Java Runtime Environment (JRE) that starts Informatica

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 Informatica. On UNIX, you can set
the memory configuration when you start Informatica.
The domain configuration database is not available. Informatica fails to start on a node if the Service

Manager on a gateway node cannot connect to the domain configuration database within 30 seconds. Verify
that the domain configuration repository is available.
You incorrectly configure the Informatica service user account. Informatica fails to start if you incorrectly

configure the Windows domain, user name, or password when you configure the user account to start the
Informatica service on Windows. In addition, the user account must have the Act as operating system
permission.
The content of the PATH environment variable exceeds the maximum length allowed. On Windows,

Informatica fails to start if files or libraries required by Informatica are not in the system path and cannot be
accessed. This problem can occur if the total number of characters in the PATH environment variable exceeds
the limit.
Some of the folders in the <InformaticaInstallationDir> directory do not have the appropriate execute

permissions. Grant execute permission on the <InformaticaInstallationDir> directory.

Pinging the Domain


The installer runs the infacmd Ping command to verify that the domain is available before it continues the
installation. The domain must be available so that license objects can be added to the domain. If the Ping
command fails, start Informatica on the gateway node.

Adding a License
The installer runs the infacmd AddLicense command to read the Informatica license key file and create a license
object in the domain. To run the application services in Informatica Administrator, a valid license object must exist
in the domain.

84

Chapter 11: Troubleshooting the Informatica Installation

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 connectivity options in the installation debug log. You
can get more information about existing licenses for the domain in Informatica Administrator.

Troubleshooting Data Transformation Server


I installed Data Transformation Server on Windows, but the environment variables are not visible.
Log off the Windows machine and then log back on to refresh the environment variables.

Troubleshooting Data Transformation Server

85

CHAPTER 12

Repository Database Configuration


This chapter includes the following topics:
Model Repository Database Requirements, 86
Profiling Warehouse Database Requirements, 88
Reference Data Database, 89
Staging Database Requirements, 89
Human Task Database Requirements, 90

Model Repository Database Requirements


Data Quality stores data and metadata in the Model repository. Before you create the Model Repository Service,
set up a database and database user account for the Model repository.
You can create the Model repository in the following relational database systems:
Oracle
IBM DB2
Microsoft SQL Server

For more information about configuring the database, see the documentation for your database system.
Use the following guidelines when you set up the Model repository database and user account:
The database must be accessible to all gateway nodes in the Informatica domain.
To prevent database errors in one repository from affecting other repositories, create the Model repository in a

separate database schema with a different database user account. Do not create the Model repository in the
same database schema as the domain configuration repository or the other repositories in the domain.

Oracle Database Requirements


Use the following guidelines when you set up the repository on Oracle:
Set the open_cursors parameter to 2000 or higher.
Verify the database user has CONNECT, RESOURCE, and CREATE VIEW privileges.

86

IBM DB2 Database Requirements


Use the following guidelines when you set up the repository on IBM DB2:
If the repository is in an IBM DB2 9.7 database, verify that IBM DB2 Version 9.7 Fix Pack 7 or a later fix pack is

installed.
On the IBM DB2 instance where you create the database, set the following parameters to ON:
- DB2_SKIPINSERTED
- DB2_EVALUNCOMMITTED
- DB2_SKIPDELETED
- AUTO_RUNSTATS
On the database, set the following configuration parameters:
Parameter

Value

applheapsz

8192

appl_ctl_heap_sz

8192

logfilsiz

8000

DynamicSections

3000

maxlocks

98

locklist

50000

auto_stmt_stats

ON
For IBM DB2 9.5 only.

Set the tablespace pageSize parameter to 32768 bytes.

In a single-partition database, specify a tablespace that meets the pageSize requirements. If you do not specify
a tablespace, the default tablespace must meet the pageSize requirements.
In a multi-partition database, you must specify a tablespace that meets the pageSize requirements. Define the
tablespace on a single node.
Verify the database user has CREATETAB, CONNECT, and BINDADD privileges.

Note: The default value for DynamicSections in DB2 is too low for the Informatica repositories. Informatica
requires a larger DB2 package than the default. When you set up the DB2 database for the domain configuration
repository or a Model repository, you must set the DynamicSections parameter to at least 3000. If the
DynamicSections parameter is set to a lower number, you can encounter problems when you install or run
Informatica. The following error message can appear:
[informatica][DB2 JDBC Driver]No more available statements. Please recreate your package with a larger
dynamicSections value.

Model Repository Database Requirements

87

Microsoft SQL Server Database Requirements


Use the following guidelines when you set up the repository on Microsoft SQL Server:
Set the read committed isolation level to READ_COMMITTED_SNAPSHOT to minimize locking contention.

To set the isolation level for the database, run the following command:
ALTER DATABASE DatabaseName SET READ_COMMITTED_SNAPSHOT ON

To verify that the isolation level for the database is correct, run the following command:
SELECT is_read_committed_snapshot_on FROM sys.databases WHERE name = DatabaseName
The database user account must have the CONNECT, CREATE TABLE, and CREATE VIEW permissions.

Profiling Warehouse Database Requirements


The profiling warehouse database stores profiling and scorecard results for the Data Integration Service. You
create the profiling warehouse when you create the Data Integration Service.
You can create the profiling warehouse database in the following relational database systems:
Oracle
IBM DB2
Microsoft SQL Server

For more information about configuring the database, see the documentation for your database system.

Oracle Database Requirements


Use the following guidelines when you set up the profiling warehouse on Oracle:
The database user account must have CONNECT, RESOURCE, CREATE VIEW, and CREATE FUNCTION

privileges.

IBM DB2 Database Requirements


Use the following guidelines when you set up the profiling warehouse on IBM DB2:
The database user account must have the CREATETAB, CONNECT, CREATE VIEW, and CREATE

FUNCTION privileges.
Set the tablespace pageSize parameter to 32768

Microsoft SQL Server Database Requirements


Use the following guidelines when you set up the profiling warehouse on Microsoft SQL Server:
The database user account must have the CONNECT, CREATE TABLE, CREATE VIEW, and CREATE

FUNCTION privileges.

88

Chapter 12: Repository Database Configuration

Reference Data Database


Data Quality stores the data values for reference table objects in the reference data database. The Model
repository stores the reference table objects that use the reference data values.
You can create the reference data database in the following relational database systems:
Oracle
IBM DB2
Microsoft SQL Server

For more information about configuring the database, see the documentation for your database system.

Oracle Database Requirements


Use the following guidelines when you set up the reference data database on Oracle:
Verify that the database user has CONNECT and RESOURCE privileges.

IBM DB2 Database Requirements


Use the following guidelines when you set up the reference data database on IBM DB2:
Verify that the database user has CREATETAB and CONNECT privileges.
Set the tablespace pageSize parameter to 32768.

Microsoft SQL Server Database Requirements


Use the following guidelines when you set up the reference data database on Microsoft SQL Server:
Verify that the database user has CONNECT and CREATE TABLE privileges.

Staging Database Requirements


Data Quality stores bad record and duplicate record data in a staging database. You configure an Exception
transformation to create tables in the staging database to store the records.
You can create the staging database in the following relational database systems:
Oracle
IBM DB2
Microsoft SQL Server

For more information about configuring the database, see the documentation for your database system.

Oracle Database Requirements


Use the following guidelines when you set up the staging database on Oracle:
Verify that the database user has CONNECT and RESOURCE privileges.

Reference Data Database

89

IBM DB2 Database Requirements


Use the following guidelines when you set up the staging database on IBM DB2:
Verify that the database user has CREATETAB and CONNECT privileges.
Set the tablespace pageSize parameter to 32768.

Microsoft SQL Server Database Requirements


Use the following guidelines when you set up the staging database on Microsoft SQL Server:
Verify that the database user has CONNECT and CREATE TABLE privileges.

Human Task Database Requirements


Data Quality stores metadata for Human tasks in the Human task database. Before you create the Human task
database, set up a database and database user account for the Model repository.
You can create the Human task database in the following relational database systems:
Oracle
IBM DB2
Microsoft SQL Server

For more information about configuring the database, see the documentation for your database system.

Oracle Database Requirements


Use the following guidelines when you set up the Human task database on Oracle:
The database user account must have CONNECT and RESOURCE privileges.
Set the following connection pooling parameters:
Parameter

Value

Maximum Connection Pool Size

128

Minimum Connection Pool Size

Maximum Idle Time

120 seconds

IBM DB2 Database Requirements


Use the following guidelines when you set up the Human task database on IBM DB2:
The database user account must have the CREATETAB and CONNECT privileges.
Set the tablespace pageSize parameter to 32768.

90

Chapter 12: Repository Database Configuration

Set the following connection pooling parameters:


Parameter

Value

Maximum Connection Pool Size

128

Minimum Connection Pool Size

Maximum Idle Time

120 seconds

Microsoft SQL Server Database Requirements


Use the following guidelines when you set up the Human task database on Microsoft SQL Server:
The database user account must have the CONNECT and CREATE TABLE privileges.
Set the following connection pooling parameters:
Parameter

Value

Maximum Connection Pool Size

128

Minimum Connection Pool Size

Maximum Idle Time

120 seconds

Human Task Database Requirements

91

CHAPTER 13

Informatica Platform Connectivity


This chapter includes the following topics:
Connectivity Overview, 92
Domain Connectivity, 92
Data Quality Connectivity, 93
Native Connectivity, 95
ODBC Connectivity, 96
JDBC Connectivity, 97

Connectivity Overview
The Informatica platform uses the following types of connectivity to communicate among clients, services, and
other components in the domain:
TCP/IP network protocol. Application services and the Service Managers in a domain use TCP/IP network

protocol to communicate with other nodes and services. The clients also use 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 the Informatica services. You can configure the port numbers used for services on a node
during installation or in Informatica Administrator.
Native drivers. The Data Integration Service uses native drivers to communicate with databases. Native

drivers are packaged with the database server and client software. Install and configure the native database
client software on the machines where the Data Integration Service runs.
ODBC. The ODBC drivers are installed with the Informatica services and the Informatica clients. The

integration services use ODBC drivers to communicate with databases.


JDBC. The Model Repository Service uses JDBC to connect to the Model repository database.

The server installer uses JDBC to connect to the domain configuration repository during installation. The
gateway nodes in the Informatica domain use JDBC to connect to the domain configuration repository.

Domain Connectivity
Services on a node in an Informatica 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 to route requests. The Service

92

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 Informatica Services.
When you create a node, you select a port number for the node. The Service Manager listens for incoming TCP/IP
connections on that port.

Data Quality Connectivity


Data Quality uses TCP/IP to connect between services and clients. The services and clients use JDBC, ODBC, or
native drivers to connect to databases.
The following figure shows an overview of the connectivity for components in Data Quality:

Data Quality uses connection objects to define connectivity information for source and target databases. The
connection objects can use native or ODBC connectivity. The Data Integration Service uses connection objects to
connect to sources and targets.
The services and clients connect in the following ways:
Model Repository Service. The Model Repository Service uses JDBC to read or write data and metadata in

the Model repository. It uses TCP/IP to communicate with the Data Integration Service and the clients.
Data Integration Service. The Data Integration Service uses ODBC or native drivers to connect and read data

from a source database and write data to a target database. It uses TCP/IP to communicate with the Model
Repository Service, Content Management Service, and client applications.
Informatica Developer. The Developer tool uses TCP/IP to send data transformation requests to the Data

Integration Service. It uses TCP/IP to communicate with the Content Management Service to manage
reference tables, probabilistic model files, and to retrieve configuration and status information for identity
population files and address validation reference data files. When you preview mappings or data objects in the
Developer tool, it uses JDBC or ODBC drivers to connect to the source or target database to fetch the
metadata required for preview.
Informatica Analyst. The Analyst tool uses TCP/IP to send requests to the Data Integration Service. It uses

TCP/IP to communicate with the Content Management Service to manage reference tables. When you preview
profiles or objects in the Analyst tool, it uses JDBC or ODBC drivers to connect to the source or target
database to fetch the metadata required for preview.

Data Quality Connectivity

93

If you use ODBC to connect to the source or target database, install the ODBC driver on the node where the
Analyst Service runs.
Content Management Service. The Content Management Service manages the locations and other properties

for the reference data that Data Quality uses. The Content Management Service uses TCP/IP to communicate
with the Data Integration Service to read and write data in reference tables. It uses JDBC to communicate
directly with the reference data database when it creates the reference tables.
If multiple instances of a Content Management Service exist in an Informatica domain, the master Content
Management Service updates the Data Integration Service. The master Content Management Service uses
TCP/IP to communicate with the Domain Service to identify the Model Repository Service and Data Integration
Service to use.
Data Director Service. The Data Director Service uses TCP/IP to communicate with the Data Integration

Service. The Data Integration Service stores the connection name of the database that contains Human task
data.
The Data Director Service runs the Informatica Data Director for Data Quality web client. Data analysts use
Informatica Data Director for Data Quality to complete any human task defined in a workflow.

Model Repository Connectivity


The Model Repository Service connects to the Model repository using JDBC drivers. Informatica Developer,
Informatica Analyst, Informatica Administrator, and the Data Integration Service communicate with the Model
Repository Service over TCP/IP. Informatica Developer, Informatica Analyst, and Data Integration Service are
Model repository clients.

94

Chapter 13: Informatica Platform Connectivity

The following figure shows how a Model repository client connects to the Model repository database:

1. A Model repository client sends a repository connection request to the master gateway node, which is the entry point to the domain.
2. The Service Manager sends back the host name and port number of the node running the Model Repository Service. In the diagram, the
Model Repository Service is running on node A.
3. The repository client establishes a TCP/IP connection with the Model Repository Service process on node A.
4. The Model Repository Service process communicates with the Model repository database over JDBC. The Model Repository Service
process stores objects in or retrieves objects from the Model repository database based on requests from the Model repository client.

Note: The Model repository tables have an open architecture. Although you can view the repository tables, never
manually edit them through other utilities. Informatica is not responsible for corrupted data that is caused by
customer alteration of the repository tables or data within those tables.

Native Connectivity
To establish native connectivity between an application service and a database, you must install the database
client software on the machine where the service runs.
The Data Integration Service uses native drivers to communicate with source and target databases.
The following table describes the syntax for the native connection string for each supported database system:
Database

Connect String Syntax

Example

IBM DB2

dbname

mydatabase

Informix

dbname@servername

mydatabase@informix

Native Connectivity

95

Database

Connect String Syntax

Example

Microsoft SQL Server

servername@dbname

sqlserver@mydatabase

Oracle

dbname.world (same as TNSNAMES entry)

oracle.world

Sybase ASE

servername@dbname

sambrown@mydatabase
Note: Sybase ASE servername is the name
of the Adaptive Server from the interfaces
file.

Teradata

ODBC_data_source_name or

TeradataODBC

ODBC_data_source_name@db_name or

TeradataODBC@mydatabase

ODBC_data_source_name@db_user_name

TeradataODBC@sambrown
Note: Use Teradata ODBC drivers to
connect to source and target databases.

ODBC Connectivity
Open Database Connectivity (ODBC) provides a common way to communicate with different database systems.
The Data Integration Service use ODBC drivers to connect to databases.
To use ODBC connectivity, you must install the following components on the machine hosting the Informatica
service or client tool:
Database client software. Install the client software for the database system. This installs the client libraries

needed to connect to the database.


Note: Some ODBC drivers contain wire protocols and do not require the database client software.
ODBC drivers. The DataDirect closed 32-bit or 64-bit ODBC drivers are installed when you install the

Informatica services. The DataDirect closed 32-bit ODBC drivers are installed when you install the Informatica
clients. The database server can also include an ODBC driver.
After you install the necessary components you must configure an ODBC data source for each database that 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.
The following table shows the recommended ODBC drivers to use with each database:

96

Database

ODBC Driver

Requires Database Client Software

Informix

DataDirect Informix Wire Protocol

No

Microsoft Access

Microsoft Access driver

No

Microsoft Excel

Microsoft Excel driver

No

Chapter 13: Informatica Platform Connectivity

Database

ODBC Driver

Requires Database Client Software

Microsoft SQL Server

DataDirect SQL Server Wire Protocol

No

Netezza

Netezza SQL

Yes

Teradata

Teradata ODBC driver

Yes

SAP HANA

SAP HANA ODBC driver

Yes

JDBC Connectivity
JDBC (Java Database Connectivity) is a Java API that provides connectivity to relational databases. Java-based
applications can use JDBC drivers to connect to databases.
The following services and clients use JDBC to connect to databases:
Model Repository Service
Informatica Developer
Informatica Analyst

JDBC drivers are installed with the Informatica services and the Informatica clients.

JDBC Connectivity

97

CHAPTER 14

JDBC and ODBC Driver Installation


This chapter includes the following topics:
JDBC and ODBC Driver Installation Overview, 98
JDBC Driver Installation, 98
ODBC Driver Installation on Windows, 99
ODBC Driver Installation on UNIX, 101

JDBC and ODBC Driver Installation Overview


To connect to an SQL data service through a third party client tool, you must install the database drivers on the
machine that you want to connect from. Download the JDBC and ODBC drivers and configure the connection
based on whether you connect through a JDBC or ODBC client tool.
When you install Informatica Services or Informatica Clients, the installers copy the JDBC and ODBC drivers to
the Informatica installation directory by default. Informatica provides a separate driver installer to install the JDBC
and ODBC drivers on a machine that does not have Informatica Services or Informatica Clients.

JDBC Driver Installation


You can connect to an SQL data service through a JDBC client tool such as the SQL SQuirreL Client or DBClient.
Before you can connect to an SQL data service through a JDBC client tool, you must perform the following tasks:
1.

Install the Informatica JDBC driver.

2.

Update the CLASSPATH environment variable.

Installing the Informatica JDBC Driver


Install the Informatica JDBC driver on the machine you connect to the SQL data service from. To install the driver,
run the Informatica JDBC/ODBC driver installation program.
The Informatica JDBC driver version must match the Data Integration Service version. For example, version 9.5.0
of the Informatica JDBC driver is not compatible with version 9.1.0 of the Data Integration Service. Similarly,
version 9.1.0 of the Informatica JDBC driver is not compatible with version 9.5.0 of the Data Integration Service.

98

Updating the CLASSPATH


Update the CLASSPATH environment variable to include the JDBC driver. The JDBC driver is compiled with Java
6.
The JDBC driver is installed in the following location:
<InformaticaInstallationDir>\tools\jdbcdrv\infadsjdbc.jar

ODBC Driver Installation on Windows


You can connect to an SQL data service through an ODBC client tool such as the MySQL ODBC Client.
Before you can connect to an SQL data service through an ODBC client tool on Windows, you must perform the
following tasks:
1.

Install the Informatica ODBC driver.

2.

Update the system path to include the Java Virtual Machine (JVM) directory.

3.

Configure the Informatica ODBC driver.

Installing or Upgrading the Informatica Data Services ODBC Driver on


Windows
Install or upgrade the Informatica Data Services ODBC Driver for PowerCenter when you use PowerCenter to
connect to an SQL data service. Install or upgrade the Informatica Data Services ODBC Driver 9.5.1 when you
connect to an SQL data service from a third-party client tool. Install the driver on the machine you connect to the
SQL data service from. You can install the driver on multiple machines in graphical or silent mode.
When you install the Informatica Data Services ODBC Driver for PowerCenter, the Informatica JDBC/ODBC driver
installation program updates the system path to include the Java Virtual Machine (jvm.dll) directory. If you install
the driver on a machine with a Windows 64-bit operating system, you must restart the machine after you run the
Informatica JDBC/ODBC driver installation program.

Installing the Informatica Data Services ODBC Driver 9.5 on Windows


Install the Informatica Data Services ODBC Driver 9.5 when you connect to an SQL data service from a third-party
client tool. Install the driver on the machine you connect to the SQL data service from. You can install the driver on
multiple machines in graphical or silent mode.

Configuring the Informatica Data Services ODBC Driver for


PowerCenter
Before you can connect to an SQL data service through an ODBC client tool on Windows, you must configure the
Informatica ODBC driver.
1.

Open the Administrative Tools from the Windows Control Panel.

2.

Open the Data Sources (ODBC) shortcut.


The ODBC Data Source Administrator appears.

3.

Click Add.

4.

Select the Informatica Data Services ODBC Driver for PowerCenter.

ODBC Driver Installation on Windows

99

5.

Click Finish.

6.

Configure the driver with the following options:


Option

Value

DSN name

Any valid data source name.

Connect string

jdbc:informatica:sqlds/<optional security domain\><optional


user name>/<optional user password>@<domain host name>:<domain
HTTP port>?dis=<Data Integration Service name>&sqlds=<runtime
SQL data service name>

JDBC Jar

<InformaticaInstallationDir>\tools\jdbcdrv\infadsjdbc.jar

Treat Length as Characters (Deferred


Parameters) *

Enabled

Multi-threaded application

Enabled

. *Enable this option only for MicroStrategy.

Configuring the Informatica Data Services ODBC Driver 9.5.1


Before you connect to an SQL data service through an ODBC client tool on Windows, configure the Informatica
Data Services ODBC Driver 9.5.1.
1.

Open the Administrative Tools from the Windows Control Panel.

2.

Open the Data Sources (ODBC) shortcut.


The ODBC Data Source Administrator appears.

3.

Click Add.

4.

Select the Informatica Data Services ODBC Driver 9.5.1.

5.

Click Finish.

6.

Configure the driver with the following options:


Option

Value

DSN Name

Any valid data source name.

Host Name

Machine that hosts the Informatica domain.

Port

Informatica domain HTTP port number.

SQL Data Service


Name

SQL data service that contains the virtual tables you want to query or the virtual stored procedures
you want to run.
By default, the SQL data service name is:
<application name>.<SQL data service name>
where <application name> is the name of the application that contains the SQL data service.

100

Data Integration
Service Name

Data Integration Service where the application that contains the SQL data service runs.

User Name

Informatica domain user name.

Chapter 14: JDBC and ODBC Driver Installation

Option

Value

Password

Informatica domain user password.

Optional
Parameters

You can use the following optional Data Integration Service configuration parameters:
optimizeLevel - Sets the mapping optimization level.
highPrecision - Runs mappings in high-precision mode.
defaultDateFormat - Connection property that specifies the date format.
defaultTimeFormat - Connection property that specifies the time format.
defaultTimeStampFormat - Connection property that specifies the date and time.
dumpMapping - Ceates XML files that represent the optimized and non-optimized eDTM
mappings.
ResultSetCacheExpirationPeriod - Amount of time in milliseconds a result set is available for
use after it is populated. If set to zero, result set caching is disabled.
Use & to separate multiple values.

Save Credentials

Saves the Informatica domain user name and password. Credentials are saved as clear text in the
registry.

ODBC Driver Installation on UNIX


You can connect to an SQL data service through an ODBC client tool such as the MySQL ODBC Client.
Before you can connect to an SQL data service through an ODBC client tool on UNIX, you must perform the
following tasks:
1.

Install the Informatica ODBC driver.

2.

Update the shared library environment variable.

3.

Update odbc.ini.

Installing or Upgrading the Informatica Data Services ODBC Driver on


UNIX
Install or upgrade the Informatica Data Services ODBC Driver for PowerCenter when you use PowerCenter to
connect to an SQL data service. Install the Informatica Data Services ODBC Driver 9.5.1 when you connect to an
SQL data service from a third-party client tool.
Install the driver on the machine you connect to the SQL data service from. You can install the driver on multiple
machines in graphical or silent mode.

Updating the Shared Library Environment Variable


Set the shared library environment variable based on the operating system.
Update the shared library environment variable to include the directories where the Java Virtual Machine and
Driver Manager library files exist.

ODBC Driver Installation on UNIX

101

The following table describes the shared library environment variable for each operating system:
Operating System

Shared Library Environment Variable

AIX

LIBPATH

HP-UX

SHLIB_PATH or LD_LIBRARY_PATH

Linux

LD_LIBRARY_PATH

Solaris

LD_LIBRARY_PATH

Update the shared library environment variable to include the following directories:
The directory where the platform libjvm and j9vm library resides.
The directory where the libodbc and libodbcinst libraries reside. This is usually the Driver Manager lib directory.

Updating odbc.ini
Before you can connect to an SQL data service through an ODBC client tool on UNIX, you must update odbc.ini.
1.

Edit odbc.ini or copy odbc.ini to the home directory and edit it. This file exists in the $ODBCHOME directory.
$ cp $ODBCHOME/odbc.ini $HOME/.odbc.ini

2.

Add an entry for the ODBC user under the section [<user name>_odbc]. For example:
[<user name>_odbc]
ConnectionString=jdbc:informatica:sqlds/<optional security domain\><optional user name>/<optional
user password>@<domain host name>:<domain HTTP port>?dis=<Data Integration Service
name>&sqlds=<runtime SQL data service name>
Driver=$ODBC_DRIVER_INSTALL_LOCATION/bin/$OS/libinfadsodbc.so
IsMultiThreaded=true
JDBCDriverLocation=<Informatica Installation Directory>/tools/jdbcdrv/infadsjdbc.jar
UseDetach=false
WCHARLengthInChars=true

Configure WCHARLengthInChars only for MicroStrategy.

Installing the Informatica Data Services ODBC Driver 9.5 on UNIX


Install the Informatica Data Services ODBC Driver for PowerCenter when you use PowerCenter to connect to an
SQL data service. Install the Informatica Data Services ODBC Driver 9.5 when you connect to an SQL data
service from a third-party client tool. Install the driver on the machine you connect to the SQL data service from.
You can install the driver on multiple machines in graphical or silent mode.

Updating the Shared Library Environment Variable


Set the shared library environment variables based on the operating system.
Update the shared library environment variable to include the driver binaries.
The following table describes the shared library environment variable for each operating system:

102

Operating System

Shared Library Environment Variable

AIX

LIBPATH

HP-UX

SHLIB_PATH or LD_LIBRARY_PATH

Chapter 14: JDBC and ODBC Driver Installation

Operating System

Shared Library Environment Variable

Linux

LD_LIBRARY_PATH

Solaris

LD_LIBRARY_PATH

Update the shared library environment variable to include the following directory:
The bin/ directory where the libinfadsodbc library resides.

The library contains the ODBC driver binaries. Typically, you can locate this library in tools/odbcdrv for the server
and client installation. For the standalone installation, you can locate the library in the installation directory.
If you use the DataDirect driver manager, create an ${OBDCINST} environment variable to point to the odbcinst.ini
file.

Updating odbc.ini and odbcinst.ini


Before you can connect to an SQL data service through an ODBC client tool on UNIX, you must update the
odbc.ini and odbcinst.ini files.
If you use the DataDirect driver manager with the ODBC driver, you can store the odbcinst.ini file in any location.
Use the ${ODBCINST} environment variable to point to the odbcinst.file.
If you use the unixODBC driver manager, you must store the odbcinst.ini file in the <DriverHome> directory. You
cannot use the ${ODBCINST} environment variable to point to the odbcinst.file.
1.

Edit the odbc.ini file or copy the odbc.ini file to the home directory and edit it. This file exists in the
$ODBCHOME directory.
$ cp $ODBCHOME/odbc.ini $HOME/.odbc.ini

2.

Add an entry for the ODBC user under the section [<DSN>]. For example:
[<DSN>]
DataIntegrationService=<Data Integration Service name>
Driver=$ODBC_DRIVER_INSTALL_LOCATION/bin/$OS/libinfadsodbc.so
HostName=<domain host name>
Port=<domain HTTP port>
SQLDataService=<runtime SQL data service name>
Optional Parameters=defaultDateFormat=DD/MM/YYYY&defaultTimeStampFormat=DD/MM/YYYY HH24:MI:SS

3.

Add the driver and setup entries to the odbcinst.ini file.


[Informatica Data Services ODBC Driver 9.5.1]
Driver=<Complete path to driver>
Setup=<Complete path to driver>

For example:
Driver=$ODBC_DRIVER_INSTALL_LOCATION/bin/$OS/libinfadsodbc.so
Setup=$ODBC_SETUP_INSTALL_LOCATION/bin/$OS/libinfadsodbc.so

ODBC Driver Installation on UNIX

103

CHAPTER 15

Informatica Utilities Installation


This chapter includes the following topics:
Informatica Utilities Installation Overview, 104
Command Line Programs and Utilities, 105
Configuring the PowerCenter Utilities, 105
Configuring the Metadata Manager Utilities, 106

Informatica Utilities Installation Overview


The Informatica installation includes customer support tools and command line programs and utilities for the
following products:
Data Explorer
Data Quality
Data Services
Metadata Manager
PowerCenter
PowerExchange

When you install the Informatica services or the Informatica clients, the command line programs and utilities are
installed by default.
You can also install and run the programs and utilities on any machine without installing the Informatica products.
Informatica provides a separate ZIP file to install the command line programs and utilities on a machine that does
not have Informatica products installed.
The Informatica utilities are included in a ZIP file. Download the following file for your operating system:
Informatica_<Version>_cmd_utilities_<OperatingSystem>.zip

To install the utilities, extract the utilities from the file on the machine where you want to run them.
Configure the path and environment variables as required by the command line utilities. Grant execute permission
on the utility files to user accounts that run the commands.

104

Command Line Programs and Utilities


You can use the Informatica utilities to manage the Informatica domain, application services, and objects from the
command line on any machine that can access the Informatica domain.
The following table describes the Informatica command line programs:
Command Line Program

Product

Description

infacmd

Data Explorer

Administer the Informatica domain and


application services and processes,
including the repository and integration
services. You can also use infacmd to
access and administer licenses and log
events and export and import objects
and user accounts.

Data Quality
Data Services
PowerCenter
PowerExchange

pmcmd

PowerCenter

Manage workflows. Use pmcmd to start,


stop, schedule, and monitor workflows.

pmpasswd

PowerCenter

Encrypt passwords to use with pmcmd


and pmrep environment variables.

pmrep

PowerCenter

Performs repository administration


tasks. Use pmrep to list repository
objects, create and edit groups, and
restore and delete repositories.

mmcmd

Metadata Manager

Load and manage resources, import


and export models, custom resources,
and business glossaries. Create and
delete Metadata Manager repository
content, and restore PowerCenter
repository content.

backupCmdLine

Metadata Manager

Back up and restore the Metadata


Manager repository.

Configuring the PowerCenter Utilities


The PowerCenter utilities are installed in the following directory:
<UtilitiesInstallationDir>/PowerCenter/server/bin

In addition, the infacmd command line program is installed in the following directory:
<UtilitiesInstallationDir>/PowerCenter/isp/bin

Before you run the PowerCenter utilities, use the following guidelines to configure the program files and variables:
infacmd requires the Java directory.
To run pmrep, pmcmd, and pmpasswd, you must copy the domains.infa file for the Informatica domain to the

utilities directory. To run pmrep, pmcmd, and pmpasswd on UNIX, you must also set INFA_HOME, the PATH
environment variable, and the library path environment variable to the location of the utilities.

Command Line Programs and Utilities

105

Configuring the Metadata Manager Utilities


The Metadata Manager utilities require access to the Informatica domain and services. Modify the utility programs
and configure the environment variables with the location of the JVM and Informatica libraries.
Note: You cannot use the mmcmd utility installed with Informatica utilities or with PowerCenter Client to create,
update, or delete Metadata Manager repository content or to restore PowerCenter repository content. You must
use the mmcmd utility installed with the Informatica services.
1.

Go to the directory where you extracted the utility files.


The Metadata Manager utilities are in the following directory:
<UtilitiesInstallationDir>\MetadataManager\utilities

2.

With a text editor, open the mmcmd.bat file on Windows or the mmcmd.sh file on UNIX.

3.

Set the JAVA_HOME environment variable to the PowerCenter java directory in the command line utilities
installation.
For example:
set JAVA_HOME=<UtilitiesInstallationDir>\PowerCenter\java

4.

Set the INFA_HOME environment variable to the PowerCenter directory in the command line utilities
installation.
For example:
set INFA_HOME=<UtilitiesInstallationDir>\PowerCenter

5.

On Solaris, verify that the LD_LIBRARY_PATH environment variable contains the following directories:
Solaris x86 64 bit
${JAVA_HOME}/jre/lib/amd64/server:${JAVA_HOME}/jre/lib/amd64/jli
Solaris Sparc 64 bit
${JAVA_HOME}/jre/lib/sparcv9/server:${JAVA_HOME}/jre/lib/sparcv9/jli
Solaris Sparc
${JAVA_HOME}/jre/lib/sparc/server

106

6.

Save the mmcmd.bat or mmcmd.sh file.

7.

Use a text editor to open the backupCmdLine.bat file on Windows or the backupCmdLine.sh file on UNIX.

8.

Repeat steps Installing Metadata Manager Utilities through Installing Metadata Manager Utilities for the
backupCmdLine.bat or backupCmdLine.sh file.

Chapter 15: Informatica Utilities Installation

CHAPTER 16

Informatica Documentation
Installation
This chapter includes the following topics:
Documentation Installation Overview, 107
Installing the Informatica Documentation, 107
Viewing the Informatica Product Documentation, 108
Troubleshooting, 108

Documentation Installation Overview


Use the Informatica Documentation DVD to install the Informatica product documentation in PDF format on
Windows.
The Informatica Documentation DVD includes the following components:
Informatica documentation in PDF format.
A browser-based application to select and view Informatica documents.

You can use the application to select and view the PDF files. To view a PDF document, you will need a PDF
viewer, such as Acrobat Reader.

Installing the Informatica Documentation


1.

On the Informatica Documentation DVD or the location where you downloaded the documentation, locate and
run the documentation installation file from the root directory:

2.

Select the language to use for installation.

install.bat

The Welcome window introduces the Informatica documentation installation.


3.

Click Next.
The Installation Directory window appears.

4.

Enter the full path of the folder where you want to install the Informatica documentation.

107

Click Choose to select the folder.


5.

Click Next.
The Pre-Installation Summary window displays the directory where the PDF files will be installed and the disk
space required.

6.

Click Install.
When the documentation installation completes, the Post-Installation Summary window indicates whether the
installation completed successfully.

7.

Click Done.
The Informatica documentation installer creates a documentation shortcut in the Informatica program group.

Viewing the Informatica Product Documentation


You can navigate through the menu pages of the Informatica documentation viewer to find the documentation you
need. The documentation files are grouped by product and version.
1.

To start the Informatica documentation application, choose Start > Programs > Informatica [Version] >
Documentation > Start Documentation [Language].
The Informatica Documentation start page opens in a web browser.

2.

On the Informatica Documentation web page, select Product Family > Product > Version > Select Guide
for the documentation that you want to view.
To search for product documentation, enter keywords in the search field and click Search.

3.

Click the name of the document to view the document.

Troubleshooting
When I try to view a PDF, I get the following error:
Install Adobe Reader to view the document.

Verify that Adobe Reader is installed on your machine. If installed, open Adobe Reader and click Help > Check
for Updates. If a later version of Adobe Reader is available, install it.

108

Chapter 16: Informatica Documentation Installation

CHAPTER 17

Uninstallation
This chapter includes the following topics:
Uninstallation Overview, 109
Informatica Server Uninstallation, 110
Informatica Clients Uninstallation, 112

Uninstallation Overview
Uninstall Informatica to remove the Informatica server or clients from a machine.
The Informatica uninstallation process deletes all Informatica files and clears all Informatica configurations from a
machine. The uninstallation process does not delete files that are not installed with Informatica. For example, the
installation process creates 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 install the Informatica server or Informatica clients, the installer creates an uninstaller. The uninstaller is
stored in the uninstallation directory.
The following table lists the uninstallation directory for each type of installation:
Installation

Uninstallation Directory Name

Informatica Server

<InformaticaInstallationDir>/Uninstaller_Server

Informatica Clients

<InformaticaInstallationDir>/Uninstaller_Client

To uninstall Informatica, use the uninstaller created during the installation. On UNIX, uninstall Informatica from the
command line. On Windows, uninstall Informatica from the Windows Start menu or Control Panel.

Rules and Guidelines for Uninstallation


Use the following rules and guidelines when you uninstall Informatica components:
The Informatica server uninstallation mode depends on the mode you use to install Informatica server. For

example, you install Informatica server in console mode. When you run the uninstaller, it runs in console mode.
The Informatica clients uninstallation mode does not depend on the mode you use to install Informatica clients.
For example, you install Informatica clients in silent mode. When you run the uninstaller, it can run in graphical
or silent mode.

109

Uninstalling Informatica does not affect the Informatica repositories. The uninstaller removes the Informatica

files. It does not remove repositories from the database. If you need to move the repositories, you can back
them up and restore them to another database.
Uninstalling Informatica does not remove the metadata tables from the domain configuration database. If you

install Informatica again using the same domain configuration database and user account, you must manually
remove the tables or choose to overwrite the tables. You can use the infasetup BackupDomain command to
back up the domain configuration database before you overwrite the metadata tables. To remove the metadata
tables manually, use the infasetup DeleteDomain command before you run the uninstaller.
Uninstalling Informatica removes all installation files and subdirectories from the <InformaticaInstallationDir>

directory. Before you uninstall Informatica, stop all Informatica services and processes and verify that all of the
files in the installation directory are closed. At the end of the uninstallation process, the uninstaller displays the
names of the files and directories that could not be removed.
The Informatica server installation creates the following folder for the files and libraries required by third party

adapters built using the Informatica Development Platform APIs:


<InformaticaInstallationDirectory>/services/shared/extensions

Uninstalling the Informatica server deletes this folder and any subfolders created under it. If you have adapter
files stored in the /extensions folder, back up the folder before you start uninstallation.

Informatica Server Uninstallation


You can uninstall the Informatica server in graphical mode and silent mode on UNIX or Windows, and in console
mode on UNIX.

Uninstalling the Informatica Server in Graphical Mode


If you installed the Informatica server in graphical mode, uninstall the Informatica server in graphical mode.

Uninstalling the Informatica Server in Graphical Mode on UNIX


Before you run the uninstaller, stop all Informatica services and processes and verify that all files in the installation
directory are closed. The uninstallation process cannot remove files that are open or are being used by a service
or process that is running.
1.

Go to the following directory:


<InformaticaInstallationDir>/Uninstaller_Server

2.

Type the following command to run the uninstaller:


./uninstaller

If you installed the Informatica server in graphical mode, the uninstaller launches in graphical mode.

Uninstalling the Informatica Server in Graphical Mode on Windows


Before you run the uninstaller, stop all Informatica services and processes and verify that all files in the installation
directory are closed. The uninstallation process cannot remove files that are open or are being used by a service
or process that is running.
1.

Click Start > Program Files > Informatica [Version] > Server > Uninstaller.
The Uninstallation page appears.

110

Chapter 17: Uninstallation

2.

Click Uninstall to begin the uninstallation.


After the installer deletes all of the Informatica files from the directory, the Post-Uninstallation Summary
page appears.

3.

Click Done to close the uninstaller.

After you uninstall the the Informatica server, delete any remaining folders and files from the
<InformaticaInstallationDir> directory. For example:
DT_<Version>_Backup folder
Informatica _<Version>_Client_InstallLog.log file
Informatica_<Version>_Client.log file

If you uninstalled the the Informatica server from a Windows 64-bit machine, and clear the Informatica-specific
CLASSPATH and PATH environment variables.

Uninstalling the Informatica Server in Console Mode


If you installed the Informatica server in console mode, uninstall the Informatica server in console mode.

Uninstalling the Informatica Server in Console Mode on UNIX


Before you run the uninstaller, stop all Informatica services and processes and verify that all files in the installation
directory are closed. The uninstallation process cannot remove files that are open or are being used by a service
or process that is running.
1.

Go to the following directory:


<InformaticaInstallationDir>/Uninstaller_Server

2.

Type the following command to run the uninstaller:


./uninstaller

If you installed the Informatica server in console mode, the uninstaller launches in console mode.

Uninstalling the Informatica Server in Silent Mode


If you installed the Informatica server in silent mode, uninstall the Informatica server in silent mode.

Uninstalling the Informatica Server in Silent Mode on UNIX


Before you run the uninstaller, stop all Informatica services and processes and verify that all files in the installation
directory are closed. The uninstallation process cannot remove files that are open or are being used by a service
or process that is running.
1.

Go to the following directory:


<InformaticaInstallationDir>/Uninstaller_Server

2.

Type the following command to run the silent uninstaller:


./uninstaller

If you installed the Informatica server in silent mode, the uninstaller launches in silent mode. The silent
uninstaller runs in the background. The process can take a while. The silent uninstallation fails if the
installation directory is not accessible.
After you uninstall the the Informatica server, delete any remaining folders and files from the
<InformaticaInstallationDir> directory. For example:
DT_<Version>_Backup folder

Informatica Server Uninstallation

111

Informatica _<Version>_Client_InstallLog.log file


Informatica_<Version>_Client.log file

Uninstalling the Informatica Server in Silent Mode on Windows


Before you run the uninstaller, stop all Informatica services and processes and verify that all files in the installation
directory are closed. The uninstallation process cannot remove files that are open or are being used by a service
or process that is running.
1.

Open a command window.

2.

Go to the following directory:


<InformaticaInstallationDir>/Uninstaller_Server

3.

Double-click the following file to run the silent uninstallation:


SilentUninstall.bat

The silent uninstaller runs in the background. The process can take a while. The silent uninstallation fails if
the installation directory is not accessible.
After you uninstall the Informatica server, delete any remaining folders and files from the
<InformaticaInstallationDir> directory. For example:
DT_<Version>_Backup folder
Informatica _<Version>_Client_InstallLog.log file
Informatica_<Version>_Client.log file

If you uninstalled the Informatica server from a Windows 64-bit machine, log out of the machine, log back in, and
clear the Informatica-specific CLASSPATH and PATH environment variables.

Informatica Clients Uninstallation


You can uninstall the Informatica clients in graphical mode and silent mode on Windows.

Uninstalling Informatica Clients in Graphical Mode


If you installed the Informatica clients in graphical mode, uninstall the Informatica clients in graphical mode.

Uninstalling Informatica Clients in Graphical Mode


1.

Click Start > Program Files > Informatica [Version] > Client > Uninstaller.
The Uninstallation page appears.

2.

Click Next.
The Application Client Uninstall Selection page appears.

3.

Select the client applications you want to uninstall and click Uninstall.

4.

Click Done to close the uninstaller.


After the uninstallation is complete, the Post-Uninstallation Summary page appears, displaying the results
of the uninstallation.

112

Chapter 17: Uninstallation

After you uninstall the Informatica clients, delete any remaining folders and files from the
<InformaticaInstallationDir> directory. For example:
DT_<Version>_Backup folder
Informatica _<Version>_Client_InstallLog.log file
Informatica_<Version>_Client.log file

If you uninstalled the Informatica clients from a Windows 64-bit machine, log out of the machine, log back in, and
clear the Informatica-specific CLASSPATH and PATH environment variables.

Uninstalling Informatica Clients in Silent Mode


If you installed the Informatica clients in silent mode, uninstall the Informatica clients in silent mode.

Configuring the Properties File


Informatica provides a sample properties file that includes the properties required by the installer.
Customize the sample properties file to create a properties file and specify the options for your uninstallation. Then
run the silent uninstallation.
1.

Go to <InformaticaInstallationDir>/Client/Uninstaller_Client.

2.

Locate the sample SilentInput.properties file.

3.

Create a backup copy of the SilentInput.properties file.

4.

Use a text editor to open and modify the values of the properties file.
The following table describes the properties that you can modify:
Property Name

Description

DXT_COMP

Indicates whether to uninstall Informatica Developer.


If the value is 1, the Developer tool will be uninstalled. If
the value is 0, the Developer tool will not be uninstalled.
Default is 1.

CLIENT_COMP

Indicates whether to uninstall PowerCenter Client.


If the value is 1, PowerCenter Client will be uninstalled. If
the value is 0, PowerCenter Client will not be uninstalled.
Default is 1.

DT_COMP

Indicates whether to uninstall Data Transformation Studio.


If the value is 1, Data Transformation Studio will be
uninstalled. If the value is 0, Data Transformation Studio
will not be uninstalled.
Default is 1.

5.

Save the SilentInput.properties file.

Running the Silent Uninstaller


After you configure the properties file, open a command window to start the silent uninstallation.
1.

Open a command window.

2.

Go to <InformaticaInstallationDir>/Uninstaller_Client.

Informatica Clients Uninstallation

113

3.

To run the silent installation, double-click the file SilentUninstall.bat.


The silent uninstaller runs in the background. The process can take a while. The silent uninstallation fails if
you incorrectly configure the properties file or if the installation directory is not accessible.

After you uninstall the Informatica clients, delete any remaining folders and files from the
<InformaticaInstallationDir> directory. For example:
DT_<Version>_Backup folder
Informatica _<Version>_Client_InstallLog.log file
Informatica_<Version>_Client.log file

If you uninstalled the Informatica clients from a Windows 64-bit machine, log out of the machine, log back in, and
clear the Informatica-specific CLASSPATH and PATH environment variables.

114

Chapter 17: Uninstallation

APPENDIX A

Connecting to Databases from


Windows
This appendix includes the following topics:
Connecting to Databases from Windows Overview, 115
Connecting to an IBM DB2 Universal Database from Windows, 115
Connecting to Microsoft Access and Microsoft Excel from Windows, 116
Connecting to a Microsoft SQL Server Database from Windows, 117
Connecting to an Oracle Database from Windows, 117
Connecting to a Sybase ASE Database from Windows, 118
Connecting to a Teradata Database from Windows, 119

Connecting to Databases from Windows Overview


To use native connectivity, you must install and configure the database client software for the database you want
to access. To ensure compatibility between the application service and the database, install a client software that
is compatible with the database version and use the appropriate database client libraries. To increase
performance, use native connectivity.
The Informatica installation includes DataDirect 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. Configure
ODBC connections using the DataDirect ODBC drivers provided by Informatica or third party ODBC drivers that
are Level 2 compliant or higher.

Connecting to an IBM DB2 Universal Database from


Windows
For native connectivity, install the version of IBM DB2 Client Application Enabler (CAE) appropriate for the IBM
DB2 database server version. To ensure compatibility between Informatica and databases, use the appropriate
database client libraries.

115

Configuring Native Connectivity


You can configure native connectivity to an IBM DB2 database to increase performance.
The following steps provide a guideline for configuring native connectivity. For specific instructions, see the
database documentation.
1.

Verify that the following environment variable settings have been established by IBM DB2 Client Application
Enabler (CAE):
DB2HOME=C:\IBM\SQLLIB
DB2INSTANCE=DB2
DB2CODEPAGE=1208 (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 IBM DB2 bin directory. For example:
PATH=C:\WINNT\SYSTEM32;C:\SQLLIB\BIN;...

3.

4.

Configure the IBM DB2 client to connect to the database that you want to access. To configure the IBM DB2
client:
a.

Launch the DB2 Configuration Assistant.

b.

Add the database connection.

c.

Bind the connection.

Run the following command in the DB2 Command Line Processor to verify that you can connect to the IBM
DB2 database:
CONNECT TO <`dbalias> USER <username> USING <password>

5.

If the connection is successful, run the TERMINATE command to disconnect from the database. If the
connection fails, see the database documentation.

Connecting to Microsoft Access and Microsoft Excel


from Windows
Configure connectivity to the following Informatica components on Windows:
Data Integration Service. Install Microsoft Access or Excel on the machine where the Data Integration Service

processes run. Create an ODBC data source for the Microsoft Access or Excel data you want to access.
Informatica Developer. Install Microsoft Access or Excel on the machine hosting the Informatica Developer.

Create an ODBC data source for the Microsoft Access or Excel data you want to access.

Configuring ODBC Connectivity


You can configure ODBC connectivity to an Access or Excel database.
The following steps provide a guideline for configuring ODBC connectivity. For specific instructions, see the
database documentation.

116

1.

Create an ODBC data source using the driver provided by Microsoft.

2.

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.

Appendix A: Connecting to Databases from Windows

Connecting to a Microsoft SQL Server Database from


Windows
For native connectivity, Informatica uses Microsoft OLE DB Provider for Microsoft SQL Server to interface to SQL
Server databases. Install and use Microsoft SQL Server Management Studio Express to verify connectivity to the
SQL Server database.

Configuring Native Connectivity


You can configure native connectivity to an a Microsoft SQL Server database to increase performance.
The OLE DB providers are installed with Microsoft SQL Server. If you cannot to connect to the database, verify
that you correctly entered all of the connectivity information. For specific connectivity instructions, see the
database documentation.

Connecting to an Oracle Database from Windows


For native connectivity, install the version of Oracle client appropriate for the Oracle database server version. To
ensure compatibility between Informatica and databases, use the appropriate database client libraries.
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 all machines that require it. To verify compatibility, contact Oracle.

Configuring Native Connectivity


You can configure native connectivity to an Oracle database to increase performance.
The following steps provide a guideline for configuring native connectivity using Oracle Net Services or Net8. For
specific connectivity instructions, see the database documentation.
1.

Verify that the Oracle home directory is set.


For example:
ORACLE_HOME=C:\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.
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 =

Connecting to a Microsoft SQL Server Database from Windows

117

(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;

To determine the value of this variable, contact the database administrator.


5.

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.

Connecting to a Sybase ASE Database from Windows


For native connectivity, install the version of Open Client appropriate for your database version. To ensure
compatibility between Informatica and databases, use the appropriate database client libraries.
Install an 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 Informatica. To verify
compatibility, contact Sybase.
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.

Configuring Native Connectivity


You can configure native connectivity to a Sybase ASE database to increase performance.
The following steps provide a guideline for configuring native connectivity. For specific instructions, see the
database documentation.
1.

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 OCS directory.
For example:
PATH=C:\SYBASE\OCS-15_0\BIN;C:\SYBASE\OCS-15_0\DLL

3.

Configure Sybase Open Client to connect to the database that you want to access.
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.

118

Appendix A: Connecting to Databases from Windows

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.

Connecting to a Teradata Database from Windows


Install and configure native client software on the machines where the Data Integration Service process runs and
where you install Informatica Developer. To ensure compatibility between Informatica and databases, use the
appropriate database client libraries. You must configure connectivity to the following Informatica components on
Windows:
Data Integration Service. Install the Teradata client, the Teradata ODBC driver, and any other Teradata client

software that you might need on the machine where the Data Integration Service runs. You must also configure
ODBC connectivity.
Informatica Developer. Install the Teradata client, the Teradata ODBC driver, and any other Teradata client

software that you might need on each machine that hosts a Developer tool that accesses Teradata. You must
also configure ODBC connectivity.
Note: Based on a recommendation from Teradata, Informatica uses ODBC to connect to Teradata. ODBC is a
native interface for Teradata.

Configuring ODBC Connectivity


You can configure ODBC connectivity to a Teradata database.
The following steps provide a guideline for configuring ODBC connectivity. For specific instructions, see the
database documentation.
1.

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 service with a Local System account logon. Create a User
DSN if you select the This account log in option to start the Informatica 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.

Configure Date Options in the Options dialog box.


In the Teradata Options dialog box, specify AAA for DateTime Format.

4.

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

Connecting to a Teradata Database from Windows

119

mode, Teradata rolls back the transaction when it 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.

120

Appendix A: Connecting to Databases from Windows

APPENDIX B

Connecting to Databases from UNIX


This appendix includes the following topics:
Connecting to Databases from UNIX Overview, 121
Connecting to an IBM DB2 Universal Database from UNIX, 121
Connecting to Microsoft SQL Server from UNIX, 122
Connecting to an Oracle Database from UNIX, 123
Connecting to a Sybase ASE Database from UNIX, 126
Connecting to a Teradata Database from UNIX, 128
Connecting to an ODBC Data Source, 130
Sample odbc.ini File, 133

Connecting to Databases from UNIX Overview


To use native connectivity, you must install and configure the database client software for the database you want
to access. To ensure compatibility between the application service and the database, install a client software that
is compatible with the database version and use the appropriate database client libraries. To increase
performance, use native connectivity.
The Informatica installation includes DataDirect 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. Configure
ODBC connections using the DataDirect ODBC drivers provided by Informatica or third party ODBC drivers that
are Level 2 compliant or higher.
Use the following guidelines when you connect to databases from Linux or UNIX:
Use native drivers to connect to IBM DB2, Oracle, or Sybase ASE databases.
You can use ODBC to connect to other sources and targets.

Connecting to an IBM DB2 Universal Database from


UNIX
For native connectivity, install the version of IBM DB2 Client Application Enabler (CAE) appropriate for the IBM
DB2 database server version. To ensure compatibility between Informatica and databases, use the appropriate
database client libraries.

121

Connecting to an IBM DB2 Universal Database from UNIX


For native connectivity, install the version of IBM DB2 Client Application Enabler (CAE) appropriate for the IBM
DB2 database server version. To ensure compatibility between Informatica and databases, use the appropriate
database client libraries.

Connecting to Microsoft SQL Server from UNIX


Use ODBC to connect to a Microsoft SQL Server database from a UNIX machine.

Configuring ODBC Connectivity


You can configure ODBC connectivity to a Microsoft SQL Server database.
The following steps provide a guideline for configuring ODBC connectivity. For specific instructions, see the
database documentation.
1.

Set the ODBCHOME environment variable to the ODBC installation directory. For example:
Using a Bourne shell:
$ ODBCHOME=<Informatica server home>/ODBC7.0; export ODBCHOME

Using a C shell:
$ setenv ODBCHOME <Informatica server home>/ODBC7.0

2.

Set the ODBCINI environment variable to the location of the odbc.ini file. For example, if the odbc.ini file is in
the $ODBCHOME directory:
Using a Bourne shell:
ODBCINI=$ODBCHOME/odbc.ini; export ODBCINI

Using a C shell:
$ setenv ODBCINI $ODBCHOME/odbc.ini

3.

Edit the existing odbc.ini file in the $ODBCHOME directory or copy this odbc.ini file to the UNIX home
directory and edit it.

4.

Add an entry for the DataDirect New SQL Server Wire Protocol driver DWsqlsxx.so provided by Informatica
under the section [ODBC Data Sources] and configure the data source. For example:

$ cp $ODBCHOME/odbc.ini $HOME/.odbc.ini

[SQL Server Wire Protocol]


Driver=/export/home/build_root/ODBC_7.0/install/lib/DWsqls26.so
Description=DataDirect SQL Server Wire Protocol
Database=<database_name>
EnableBulkLoad=0
EnableQuotedIdentifiers=0
FailoverGranularity=0
FailoverMode=0
FailoverPreconnect=0
FetchTSWTZasTimestamp=0
FetchTWFSasTime=1
GSSClient=native
HostName=<SQL_Server_host>
EncryptionMethod=0
ValidateServerCertificate=0
TrustStore=
TrustStorePassword=
HostNameInCertificate=
InitializationString=
Language=

122

Appendix B: Connecting to Databases from UNIX

To ensure consistent data in Microsoft SQL Server repositories, go to the Create a New Data Source to SQL
Server dialog box and clear the Create temporary stored procedures for prepared SQL statements check box.
5.

Set the PATH and shared library environment variables by executing the script odbc.sh or odbc.csh in the
$ODBCHOME directory.
Using a Bourne shell:
sh odbc.sh

Using a C shell:
source odbc.csh

6.

Verify that you can connect to the SQL Server database using the ODBC data source. If the connection fails,
see the database documentation.

Configuring SSL Authentication through ODBC


You can configure SSL authentication for Microsoft SQL Server through ODBC using the DataDirect New SQL
Server Wire Protocol driver.
1.

Open the odbc.ini file and add an entry for the ODBC data source and DataDirect New SQL Server Wire
Protocol driver under the section [ODBC Data Sources].

2.

Add the following attributes in the odbc.ini file for configuring SSL:
Attribute

Description

EncryptionMethod

The method that the driver uses to encrypt the data sent
between the driver and the database server. Set the value
to 1 to encrypt data using SSL.

ValidateServerCertificate

Determines whether the driver validates the certificate sent


by the database server when SSL encryption is enabled.
Set the value to 1 for the driver to validate the server
certificate.

TrustStore

The location and name of the trust store file. The trust
store file contains a list of Certificate Authorities (CAs) that
the driver uses for SSL server authentication.

TrustStorePassword

The password to access the contents of the trust store file.

HostNameInCertificate

Optional. The host name that is established by the SSL


administrator for the driver to validate the host name
contained in the certificate.

Connecting to an Oracle Database from UNIX


For native connectivity, install the version of Oracle client appropriate for the Oracle database server version. To
ensure compatibility between Informatica and databases, use the appropriate database client libraries.
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 all machines that require it. To verify compatibility, contact Oracle.

Connecting to an Oracle Database from UNIX

123

Configuring Native Connectivity


You can configure native connectivity to an Oracle database to increase performance.
The following steps provide a guideline for configuring native connectivity through Oracle Net Services or Net8.
For specific instructions, see the database documentation.
1.

To configure connectivity for the Data Integration Service process, log in to the machine as a user who can
start the server process.

2.

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

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 Data Integration 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 Informatica installation directory (server_dir) .

124

Appendix B: Connecting to Databases from UNIX

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

Variable

Solaris

LD_LIBRARY_PATH

Linux

LD_LIBRARY_PATH

AIX

LIBPATH

HP-UX

SHLIB_PATH

For example, use the following syntax for Solaris and Linux:
Using a Bourne shell:
$ LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:$HOME/server_dir:$ORACLE_HOME/lib; export LD_LIBRARY_PATH
Using a C shell:
$ setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:$HOME/server_dir:$ORACLE_HOME/lib

For HP-UX
Using a Bourne shell:
$ SHLIB_PATH=${SHLIB_PATH}:$HOME/server_dir:$ORACLE_HOME/lib; export SHLIB_PATH
Using a C shell:
$ setenv SHLIB_PATH ${SHLIB_PATH}:$HOME/server_dir:$ORACLE_HOME/lib

For AIX
Using a Bourne shell:
$ LIBPATH=${LIBPATH}:$HOME/server_dir:$ORACLE_HOME/lib; export LIBPATH
Using a C shell:
$ setenv LIBPATH ${LIBPATH}:$HOME/server_dir:$ORACLE_HOME/lib

4.

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 run 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)

Connecting to an Oracle Database from UNIX

125

)
)
(CONNECT_DATA =
(SID = MYORA7)
(GLOBAL_NAMES = mydatabase.world)

6.

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 user name and connect string as defined in tnsnames.ora.

Connecting to a Sybase ASE Database from UNIX


For native connectivity, install the version of Open Client appropriate for your database version. To ensure
compatibility between Informatica and databases, use the appropriate database client libraries.
Install an 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 Informatica. To verify
compatibility, contact Sybase.
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.

Configuring Native Connectivity


You can configure native connectivity to a Sybase ASE database to increase performance.
The following steps provide a guideline for configuring native connectivity. For specific instructions, see the
database documentation.
1.

To configure connectivity to the Data Integration Service process, log in to the machine as a user who can
start the server process.

2.

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 OCS bin directory.
Using a Bourne shell:
$ PATH=${PATH}:/usr/sybase/OCS-15_0/bin; export PATH

Using a C shell:
$ setenv PATH ${PATH}:/usr/sybase/OCS-15_0/bin

3.

Set the shared library environment variable.


The Sybase Open Client software contains a number of shared library components that the Data Integration
Service processes load dynamically. To locate the shared libraries during run time, set the shared library
environment variable.

126

Appendix B: Connecting to Databases from UNIX

The shared library path must also include the installation directory of the Informatica services (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

Variable

Solaris

LD_LIBRARY_PATH

Linux

LD_LIBRARY_PATH

AIX

LIBPATH

HP-UX

SHLIB_PATH

For example, use the following syntax for Solaris and Linux:
Using a Bourne shell:
$ LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:$HOME/server_dir:$SYBASE/OCS-15_0/lib;$SYBASE/OCS-15_0/
lib3p;$SYBASE/OCS-15_0/lib3p64; export LD_LIBRARY_PATH
Using a C shell:
$ setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:$HOME/server_dir:$SYBASE/OCS-15_0/lib;$SYBASE/
OCS-15_0/lib3p;$SYBASE/OCS-15_0/lib3p64;

For HP-UX
Using a Bourne shell:
$ SHLIB_PATH=${SHLIB_PATH}:$HOME/server_dir:$SYBASE/OCS-15_0/lib;$SYBASE/OCS-15_0/lib3p;$SYBASE/
OCS-15_0/lib3p64; export SHLIB_PATH
Using a C shell:
$ setenv SHLIB_PATH ${SHLIB_PATH}:$HOME/server_dir:$SYBASE/OCS-15_0/lib;$SYBASE/OCS-15_0/lib3p;
$SYBASE/OCS-15_0/lib3p64;

For AIX
Using a Bourne shell:
$ LIBPATH=${LIBPATH}:$HOME/server_dir:$SYBASE/OCS-15_0/lib;$SYBASE/OCS-15_0/lib3p;$SYBASE/
OCS-15_0/lib3p64; export LIBPATH
Using a C shell:
$ setenv LIBPATH ${LIBPATH}:$HOME/server_dir:$SYBASE/OCS-15_0/lib;$SYBASE/OCS-15_0/lib3p;
$SYBASE/OCS-15_0/lib3p64;

4.

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 run the source command.
Using a Bourne shell:
$ source .profile

Using a C shell:
$ source .cshrc

5.

Verify the Sybase ASE server name in the Sybase interfaces file stored in the $SYBASE directory.

6.

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.

Connecting to a Sybase ASE Database from UNIX

127

Connecting to a Teradata Database from UNIX


Install and configure native client software on the machines where the Data Integration Service process runs and
where you install Informatica Developer. To ensure compatibility between Informatica and databases, use the
appropriate database client libraries. You must configure connectivity to the following Informatica components:
Data Integration Service. Install the Teradata client, the Teradata ODBC driver, and any other Teradata client

software that you might need on the machine where the Data Integration Service runs. You must also configure
ODBC connectivity.
Note: Based on a recommendation from Teradata, Informatica uses ODBC to connect to Teradata. ODBC is a
native interface for Teradata.

Configuring ODBC Connectivity


You can configure ODBC connectivity to a Teradata database.
The following steps provide a guideline for configuring ODBC connectivity. For specific instructions, see the
database documentation.
1.

To configure connectivity for the integration service process, log in to the machine as a user who can start a
service process.

2.

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 ddtestlib utility, to verify that the DataDirect ODBC driver 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

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 installation directory of the Informatica service (server_dir) .

128

Appendix B: Connecting to Databases from UNIX

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

Variable

Solaris

LD_LIBRARY_PATH

Linux

LD_LIBRARY_PATH

AIX

LIBPATH

HP-UX

SHLIB_PATH

For example, use the following syntax for Solaris:


Using a Bourne shell:
$ LD_LIBRARY_PATH="${LD_LIBRARY_PATH}:$HOME/server_dir:$ODBCHOME/lib:
$TERADATA_HOME/lib:$TERADATA_HOME/odbc/lib";
export LD_LIBRARY_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 Bourne shell:
$ SHLIB_PATH=${SHLIB_PATH}:$HOME/server_dir:$ODBCHOME/lib; export SHLIB_PATH
Using a C shell:
$ setenv SHLIB_PATH ${SHLIB_PATH}:$HOME/server_dir:$ODBCHOME/lib

For AIX
Using a Bourne shell:
$ LIBPATH=${LIBPATH}:$HOME/server_dir:$ODBCHOME/lib; export LIBPATH
Using a C shell:
$ setenv LIBPATH ${LIBPATH}:$HOME/server_dir:$ODBCHOME/lib

4.

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.
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.

Set the DateTimeFormat to AAA in the Teradata data ODBC configuration.

Connecting to a Teradata Database from UNIX

129

6.

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.

7.

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, see the Teradata ODBC driver documentation.

8.

Verify that the last entry in the odbc.ini is InstallDir and set it to the odbc installation directory.
For example:
InstallDir=/export/build/Informatica/9.5.1/ODBC7.0

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 run 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 ddtestlib utility to verify that the DataDirect ODBC driver manager can load the
driver file.
For example, if you have the driver entry:
Driver=/u01/app/teradata/td-tuf611/odbc/drivers/tdata.so

run the following command:


ddtestlib /u01/app/teradata/td-tuf611/odbc/drivers/tdata.so

12.

Test the connection using BTEQ or another Teradata client tool.

Connecting to an ODBC Data Source


Install and configure native client software on the machine where the Data Integration Service runs. Also install
and configure any underlying client access software required by the ODBC driver. To ensure compatibility between
Informatica and the databases, use the appropriate database client libraries.
The Informatica installation includes DataDirect ODBC drivers. If the odbc.ini file contains connections that use
earlier versions of the ODBC driver, update the connection information to use the new drivers. Use the System
DSN to specify an ODBC data source on Windows.
1.

On the machine where the Data Integration Service runs, log in as a user who can start a service process.

2.

Set the ODBCHOME and PATH environment variables.


ODBCHOME. Set to the DataDirect ODBC installation directory. For example, if the install directory is /opt/
ODBC7.0.
Using a Bourne shell:
$ ODBCHOME=/opt/ODBC7.0; export ODBCHOME

130

Appendix B: Connecting to Databases from UNIX

Using a C shell:
$ setenv ODBCHOME /opt/ODBC7.0

PATH. To run the ODBC command line programs, like ddtestlib, 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 ddtestlib utility to verify that the DataDirect ODBC driver 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 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 Informatica 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

Variable

Solaris

LD_LIBRARY_PATH

Linux

LD_LIBRARY_PATH

AIX

LIBPATH

HP-UX

SHLIB_PATH

For example, use the following syntax for Solaris and Linux:
Using a Bourne shell:
$ LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:$HOME/server_dir:$ODBCHOME/lib; export LD_LIBRARY_PATH
Using a C shell:
$ setenv LD_LIBRARY_PATH $HOME/server_dir:$ODBCHOME:${LD_LIBRARY_PATH}

For HP-UX
Using a Bourne shell:
$ SHLIB_PATH=${SHLIB_PATH}:$HOME/server_dir:$ODBCHOME/lib; export SHLIB_PATH
Using a C shell:
$ setenv SHLIB_PATH ${SHLIB_PATH}:$HOME/server_dir:$ODBCHOME/lib

For AIX
Using a Bourne shell:
$ LIBPATH=${LIBPATH}:$HOME/server_dir:$ODBCHOME/lib; export LIBPATH
Using a C shell:
$ setenv LIBPATH ${LIBPATH}:$HOME/server_dir:$ODBCHOME/lib

4.

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

Connecting to an ODBC Data Source

131

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 7.0 SQL Server Wire Protocol
Database=<SQLServer_database_name>
LogonID=<username>
Password=<password>
Address=<TCP/IP address>,<port number>
QuoteId=No
AnsiNPW=No
ApplicationsUsingThreads=1

This file might already exist if you have configured one or more ODBC data sources.
5.

Verify that the last entry in the odbc.ini is InstallDir and set it to the odbc installation directory.
For example:
InstallDir=/export/build/Informatica/9.5.1/ODBC7.0

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 run the source command.
Using a Bourne shell:
$ source .profile

Using a C shell:
$ source .cshrc

8.

Use the ddtestlib utility to verify that the DataDirect ODBC driver 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

run the following command:


ddtestlib /opt/odbc/lib/DWxxxx.so

9.

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 Sybase IQ, you must install the Sybase IQ
network client software and set the appropriate environment variables.
If you are using the ODBC drivers provided by informatica (DWxxxx26.so), instead of manually setting the
PATH and shared library path environment variables, you can also execute the script odbc.sh or odbc.csh
present under $ODBCHOME folder. This script will set the required PATH and shared library path
environment variables for the ODBC drivers provided by Informatica.

132

Appendix B: Connecting to Databases from UNIX

Sample odbc.ini File


[ODBC Data Sources]
Informix Wire Protocol=DataDirect 7.0 Informix Wire Protocol
SQL Server Wire Protocol=DataDirect 7.0 SQL Server Wire Protocol
[ODBC]
IANAAppCodePage=4
InstallDir=/export/home/install/Informatica/9.5.1
Trace=0
TraceFile=odbctrace.out
TraceDll=/export/home/install/Informatica/9.5.1/ODBC7.0/lib/DWtrc26.so
[Informix Wire Protocol]
Driver=/export/home/install/Informatica/9.5.1/ODBC7.0/lib/DWifcl26.so
Description=DataDirect 7.0 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
UseDelimitedIdentifiers=0
[SQL Server Wire Protocol]
Driver=/export/home/install/Informatica/9.5.1/ODBC7.0/lib/DWsqls26.so
Description=DataDirect 7.0 New SQL Server Wire Protocol
AlternateServers=
AlwaysReportTriggerResults=0
AnsiNPW=1
ApplicationName=
ApplicationUsingThreads=1
AuthenticationMethod=1
BulkBinaryThreshold=32
BulkCharacterThreshold=-1
BulkLoadBatchSize=1024
BulkLoadOptions=2
ConnectionReset=0
ConnectionRetryCount=0
ConnectionRetryDelay=3
Database=<database_name>
EnableBulkLoad=0
EnableQuotedIdentifiers=0
EncryptionMethod=0
FailoverGranularity=0
FailoverMode=0
FailoverPreconnect=0
FetchTSWTZasTimestamp=0
FetchTWFSasTime=1
GSSClient=native
HostName=<SQL_Server_host>
HostNameInCertificate=
InitializationString=
Language=
LoadBalanceTimeout=0
LoadBalancing=0
LoginTimeout=15
LogonID=
MaxPoolSize=100
MinPoolSize=0
PacketSize=-1
Password=
Pooling=0
PortNumber=<SQL_Server_server_port>
QueryTimeout=0
ReportCodePageConversionErrors=0
SnapshotSerializable=0

Sample odbc.ini File

133

TrustStore=
TrustStorePassword=
ValidateServerCertificate=1
WorkStationID=
XML Describe Type=-10
[SAP HANA source]
Driver=/usr/sap/hdbclient/libodbcHDB.so
DriverUnicodeType=1
ServerNode=<server_node>:<port>

134

Appendix B: Connecting to Databases from UNIX

APPENDIX C

Updating the DynamicSections


Parameter of a DB2 Database
This appendix includes the following topics:
DynamicSections Parameter Overview, 135
Updating the DynamicSections Parameter, 135

DynamicSections Parameter Overview


IBM DB2 packages contain the SQL statements to be executed on the database server. The DynamicSections
parameter of a DB2 database determines the maximum number of executable statements that the database driver
can have in a package. You can raise the value of the DynamicSections parameter to allow a larger number of
executable statements in a DB2 package. To modify the DynamicSections parameter, connect to the database
using a system administrator user account with BINDADD authority.

Updating the DynamicSections Parameter


Use the DataDirect Connect for JDBC utility to raise the value of the DynamicSections parameter in the DB2
database.
To use the DataDirect Connect for JDBC utility to update the DynamicSections parameter, complete the following
tasks:
Download and install the DataDirect Connect for JDBC utility.
Run the Test for JDBC tool.

Downloading and Installing the DataDirect Connect for JDBC Utility


Download the DataDirect Connect for JDBC utility from the DataDirect download web site to a machine that has
access to the DB2 database server. Extract the contents of the connectjdbc.jar file and run the installer.
1.

Go to the DataDirect download site:


http://www.datadirect.com/download/index.ssp

2.

Click the JDBC link and register to download the DataDirect Connect for JDBC Utility.

135

3.

Download the utility to a machine that has access to the DB2 database server.

4.

Extract the contents of the connectjdbc.jar file to a temporary directory.

5.

In the directory where you extracted the connectjdbc.jar file, run the installer.
On Windows, run installer.bat. On UNIX, run installer.sh. You can use eval as a license key.

When the installation completes, the installation program creates a folder named testforjdbc in the directory where
you extracted the connectjdbc.jar file.

Running the Test for JDBC Tool


After you install the DataDirect Connect for JDBC Utility, run the Test for JDBC tool to connect to the DB2
database. You must use a system administrator user account with the BINDADD authority to connect to the
database.
1.

In the DB2 database, set up a system adminstrator user account with the BINDADD authority.

2.

In the directory where you installed the DataDirect Connect for JDBC Utility, run the Test for JDBC tool.
On Windows, run testforjdbc.bat. On UNIX, run testforjdbc.sh.

3.

On the Test for JDBC Tool window, click Press Here to Continue.

4.

Click Connection > Connect to DB.

5.

In the Database field, enter the following text:


jdbc:datadirect:db2://
HostName:PortNumber;databaseName=DatabaseName;CreateDefaultPackage=TRUE;ReplacePackage=TRUE;Dynamic
Sections=3000

HostName is the name of the machine hosting the DB2 database server.
PortNumber is the port number of the database.
DatabaseName is the name of the DB2 database.

136

6.

In the User Name and Password fields, enter the system administrator user name and password you use to
connect to the DB2 database.

7.

Click Connect, and then close the window.

Appendix C: Updating the DynamicSections Parameter of a DB2 Database

APPENDIX D

Installation and Configuration


Checklist
This appendix includes the following topics:
Installation Checklist Overview, 137
Before You Install, 137
Informatica Services Installation, 138
Informatica Client Installation, 139
After You Install, 139

Installation Checklist Overview


The installation and configuration checklist summarizes the tasks that you must perform to complete an
installation. If you install the Informatica product on more than one machine, complete the first installation using
the detailed instructions in this guide. You can use this checklist to perform subsequent installations.

Before You Install


Before you install the Informatica services or clients, prepare the machines where you plan to install Informatica
services and clients. If you install multiple products, complete the pre-installation tasks only once.
Complete the following pre-installation tasks:
1.

Verify the system requirements for Informatica services and clients.


Run the Informatica Pre-Installation (i9Pi) System Check tool to verify that the machines where you install the
Informatica services and clients meet the system and disk space requirements. If required, modify the
machine settings before you start the installation.

2.

Verify the license key.


Before you install the software, verify that you have the license key for the product you plan to install. Contact
Informatica Global Customer Support if you do not have a license key or if you have an incremental license
key and you want to create a domain.

3.

Uninstall the previous version of Data Transformation, if applicable.


Back up essential files before you uninstall Data Transformation.

137

4.

For AIX, HP-UX and zLinux, install Java Development Kit.

5.

Configure the environment variables.


Configure the environment variables to work with the Informatica installation.

6.

Determine the ports available for Informatica.


The installer sets up the ports for components in the Informatica domain. It also designates the ports to use
for application service processes that run on the node where you install Informatica.
Domain port. Default is 6005.
Service Manager port. Default is 6006.
Service Manager shutdown port. Default is 6007.
Informatica Administrator port. Default is 6008.
Informatica Administrator shutdown port. Default is 6009.
Range of ports for application services. Default range is 6013 to 6113.

7.

Create a system user account to install Informatica.


Create a system user account to perform the installation and to run the Informatica service or daemon. Verify
that the user account you use to install Informatica has write permission on the installation directory.

8.

Optionally, set up a keystore file for a secure connection.


To use a secure connection between the Administrator tool and the Service Manager, set up a keystore for
use with Informatica.

9.

For UNIX and Linux, verify the file descriptor settings.


Verify that the operating system meets the file descriptor requirement.

10.

For UNIX, set up the X Window server for graphical mode installation.
The Informatica installer requires a graphics display server to run in graphical mode.

11.

Set up the database and user account for the domain configuration repository.
Verify the database requirements before you set up the database. The requirements differ based on the type
of database you use for the domain configuration repository.

12.

Verify that the third party software is installed for Informatica Developer.
Informatica Developer requires third party software to perform certain operations. Verify that the machine
where you install Informatica Developer has the required software.

RELATED TOPICS:
Before You Begin on page 4

Informatica Services Installation


Use the Informatica server installer to install the Informatica services on a Windows or UNIX machine. You can
install the Informatica services on multiple machines to create multiple nodes.

138

Appendix D: Installation and Configuration Checklist

RELATED TOPICS:
Informatica Services Installation on page 22

Informatica Client Installation


Use the Informatica client installer to install the Informatica clients on Windows.
You can install the following Informatica client applications:
Informatica Developer
PowerCenter Client
Data Transformation Studio

If you install multiple products, you can install the following client applications on the same machine or separate
machines:
Informatica Developer for use with Data Explorer, Data Services, and Data Quality.
PowerCenter Client for use with PowerCenter.
Data Tranformation Studio for use with Data Transformation

RELATED TOPICS:
Informatica Clients Installation on page 71

After You Install


After you install the Informatica product, complete the configuration tasks to ensure that the Informatica services
and clients run properly. If you install multiple products, complete the post-installation tasks only once.
Complete the following post-installation tasks:
1.

Configure the environment variables.


Configure the environment variables that Informatica uses when it runs the application services and connects
to the clients.

2.

For gateway nodes that run on UNIX, verify that a graphics display server is available.

3.

Configure the web browser.


You can use Microsoft Internet Explorer or Mozilla Firefox to launch the web client applications in the
Informatica platform. Configure to the browser to work with the Informatica web clients.

4.

Install languages for the Informatica client tools.


To view languages other than the system locale when you work with repositories that use a UTF-8 code page,
install additional languages on Windows for use with the Informatica clients.

5.

Verify the setup for 32-bit and 64-bit platforms.


You can run Informatica on 32-bit or 64-bit platforms. When you run Informatica on both 32-bit and 64-bit
platforms, configure Informatica to use the correct libraries, database clients, and session cache sizes.

6.

Install the database client software on each machine where the Data Integration Service runs.

7.

Verify third-party software requirements.

Informatica Client Installation

139

Informatica requires third-party software and libraries to perform certain operations. Verify that the machine
where you install Informatica has the required software or library.
8.

Optionally, install the Informatica utilities.

9.

Optionally, install the Informatica product documentation.

RELATED TOPICS:
After You Install
Informatica Utilities Installation on page 104
Informatica Documentation Installation on page 107

140

Appendix D: Installation and Configuration Checklist

INDEX

ActiveX
Microsoft Internet Explorer 77
AddLicense (infacmd)
troubleshooting 84
AIX
configuring X Virtual Frame Buffer (Xvfb) 76

Data Analyzer
ODBC (Open Database Connectivity) 92
Data Director Service
connectivity 93
Data Integration Service
connectivity 93
Data Transformation Server
troubleshooting 85
database client
configuring 60
environment variables 60
install for Informatica client tools 60
database drivers
Integration Service 92
Repository Service 92
database requirements
installation requirements 18
databases
connecting to (UNIX) 121
connecting to (Windows) 115
connecting to IBM DB2 115, 121, 122
connecting to Microsoft Access 116
connecting to Microsoft SQL Server 117
connecting to Oracle 117, 123
connecting to Sybase ASE 118, 126
connecting to Teradata (UNIX) 128
connecting to Teradata (Windows) 119
testing connections 60
DataDirect ODBC drivers
platform-specific drivers required 96
dbs2 connect
testing database connection 60
debug log
troubleshooting the installation 81
disk space requirements
client installation requirements 69
installation requirements 8, 13
DISPLAY
environment variables 13
documentation
installing 107
using the viewer 108
Domain Activity Reporting
setting up on UNIX 76
domain configuration database
troubleshooting 83
domain configuration repository
requirements 18
domain configuration repository database
installation requirements 19

B
backing up files
before uninstallation 5

C
catalina.out
troubleshooting installation 82
CLASSPATH
updating 99
connect string
examples 95
syntax 95
connecting
Integration Service to IBM DB2 (Windows) 115, 121, 122
Integration Service to Microsoft Access 116
Integration Service to Microsoft SQL Server 117
Integration Service to ODBC data sources (UNIX) 130
Integration Service to Oracle (UNIX) 123
Integration Service to Oracle (Windows) 117
Integration Service to Sybase ASE (UNIX) 126
Integration Service to Sybase ASE (Windows) 118
Microsoft Excel to Integration Service 116
to UNIX databases 121
to Windows databases 115
connection strings
native connectivity 95
connectivity
connect string examples 95
Content Management Service 93
Data Director Service 93
Data Integration Service 93
diagram of 92
Informatica Analyst 93
Informatica Developer 93
Model Repository Service 93
overview 92
Content Management Service
connectivity 93

141

E
environment variables
configuring for PowerCenter 55
database client 60
DISPLAY 10
installation 8, 13
LANG 57
LANG_C 57
LC_ALL 57
LC_CTYPE 57
library path 57
locale 57
UNIX 55
UNIX database client 60

G
graphical mode
installation requirements 10

H
HP-UX
configuring X Virtual Frame Buffer (Xvfb) 76
HTTPS
installation requirements 10, 15

I
IATEMPDIR
environment variables 8, 13
IBM DB2
connect string syntax 95
connecting to Integration Service (Windows) 115, 121, 122
setting DB2CODEPAGE 116
setting DB2INSTANCE 116
incremental license key
verifying 4
infacmd
nodes, adding to domains 83
pinging objects 84
infasetup
domains, defining 83
worker nodes, defining 83
Informatica
uninstalling 109
Informatica Administrator
logging in 64
Informatica Analyst
connectivity 93
Informatica clients
uninstalling 109
Informatica Clients
uninstalling 112
Informatica Data Explorer
connectivity 93
Informatica Data Quality
connectivity 93
Informatica Data Services
connectivity 93
Informatica Developer
configuring local workspace directory 78
connectivity 93
installing languages 77

142

Index

local machine 78
remote machine 78
Informatica domain
description 2, 3
Informatica JDBC driver
installing 98
Informatica ODBC driver
configuring 99
installing on UNIX 101
installing on Windows 99
Informatica server
uninstalling 109
Informatica Server
uninstalling 110
Informatica Services
configuring 65
starting and stopping on UNIX 63
troubleshooting 84
Informix
connect string syntax 95
installation log
description 82
installation requirements
database requirements 18
disk space 8, 13
domain configuration repository database 19
environment variables 8, 13
keystore file 10, 15
minimum system requirements 8, 13
temporary disk space 69
X Window Server 10
installing
PowerCenter documentation 107
Integration Service
ODBC (Open Database Connectivity) 92
isql
testing database connection 60

J
Javascript
configuring in Firefox 77
JDBC (Java Database Connectivity)
overview 97
JDBC client connections
installing the driver 98
updating the CLASSPATH 99
JDBC drivers
Data Analyzer 92
Metadata Manager 92
PowerCenter domain 92
Reference Table Manager 92
JRE_HOME
environment variables 8, 13

K
keystore file
installation requirements 10, 15

L
LANG
environment variable 57
locale environment variables 8, 13

languages
for client tools 77
installing on Windows 77
LC_ALL
environment variable 57
locale environment variables 8, 13
LC_CTYPE
environment variable 57
LD_LIBRARY_PATH
updating 101
LIBPATH
updating 101
library path
environment variables 8
license key
verifying 4
licenses
adding 84
Linux
configuring X Virtual Frame Buffer (Xvfb) 76
database client environment variables 60
library paths 57
locale environment variables
configuring 57
log files
catalina.out 82
debug log 81
installation 81
installation log 82
node.log 82
types 81

M
Metadata Manager
ODBC (Open Database Connectivity) 92
Microsoft Access
connecting to Integration Service 116
Microsoft Excel
connecting to Integration Service 116
using PmNullPasswd 116
using PmNullUser 116
Microsoft SQL Server
connect string syntax 95
connecting from UNIX 122
connecting to Integration Service 117
Model Repository Service
connectivity 93
Mozilla Firefox
configuring 77

N
node.log
troubleshooting installation 82
nodes
TCP/IP network protocol 92
troubleshooting 83

O
ODBC (Open Database Connectivity)
DataDirect driver issues 96
establishing connectivity 96
Integration Service 92
Metadata Manager 92

PowerCenter Client 92
ODBC client connections on UNIX
installing the driver 101
updating odbc.ini 102
updating the shared library 101
ODBC client connections on Windows
configuring the driver 99
installing the driver 99
ODBC data sources
connecting to (UNIX) 130
connecting to (Windows) 115
odbc.ini
updating 102
odbc.ini file
sample 133
Oracle
connect string syntax 95
connecting to Integration Service (UNIX) 123
connecting to Integration Service (Windows) 117
Oracle Net Services
using to connect Integration Service to Oracle (UNIX) 123
using to connect Integration Service to Oracle (Windows) 117
Overview
before you begin 4
pre-installation tasks 7, 69

P
PATH
environment variables 8
PDF filles
Informatica documentation 108
Ping (infacmd)
troubleshooting 84
pop-up blocker
avoiding in Data Analyzer 77
PowerCenter
connectivity 92
PowerCenter Client
installing languages 77
ODBC (Open Database Connectivity) 92
TCP/IP network protocol 92
PowerCenter domains
connectivity 92
pinging 84
TCP/IP network protocol 92
troubleshooting 83
prerequisites
third party requirements 60

S
samples
odbc.ini file 133
server component
Informatica 2, 3
Service Manager
log files 82
services
starting and stopping 63
shared library environment variable
updating 101
SHLIB_PATH
updating 101
64-bit platforms
guidelines 59

Index

143

supported platforms 59
Solaris
configuring X Virtual Frame Buffer (Xvfb) 76
source databases
connecting through ODBC (UNIX) 130
SQL data services
JDBC client connections 98
ODBC client connections on UNIX 101
ODBC client connections on Windows 99
sqlplus
testing database connection 60
Sybase ASE
connect string syntax 95
connecting to Integration Service (UNIX) 126
connecting to Integration Service (Windows) 118
system requirements
minimum installation requirements 8, 13

T
target databases
connecting through ODBC (UNIX) 130
TCP/IP network protocol
nodes 92
PowerCenter Client 92
PowerCenter domains 92
Teradata
connect string syntax 95
connecting to an Informatica client (UNIX) 128
connecting to an Informatica client (Windows) 119
connecting to an integration service (UNIX) 128
connecting to an integration service (Windows) 119
third party requirements
prerequisites 60
troubleshooting
creating a domain 83
Data Transformation Server 85
domain configuration database 83

144

Index

Informatica Services 84
joining a domain 83
licenses 84
pinging a domain 84

U
uninstallation
rules and guidelines 109
uninstalling
before upgrade or migration 5
Data Transformation 5
file backup before 5
UNIX
connecting to ODBC data sources 130
database client environment variables 60
database client variables 60
environment variables 55
library paths 57
user account 10
user account
UNIX 10

W
web browser
configuring 77

X
X Virtual Frame Buffer (Xvfb)
installing on UNIX 76
X Window Server
installation requirements 10