MDM 1000 InstallationGuideForWebLogicMSSQL en

Download as pdf or txt
Download as pdf or txt
You are on page 1of 112

Informatica MDM Multidomain Edition for

Microsoft SQL Server (Version 10.0.0)

Installation Guide for


WebLogic
Informatica MDM Multidomain Edition for Microsoft SQL Server Installation Guide for WebLogic

Version 10.0.0
November 2014

Copyright (c) 1993-2015 Informatica Corporation. 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. Copyright © Jinfonet Software. All rights reserved. Copyright © Apple Inc. All
rights reserved. Copyright © Telerik Inc. All rights reserved. Copyright © BEA Systems. All rights reserved. Copyright © PDFlib GmbH. All rights reserved. Copyright ©
Orientation in Objects GmbH. All rights reserved. Copyright © Tanuki Software, Ltd. All rights reserved. Copyright © Ricebridge. All rights reserved. Copyright © Sencha,
Inc. All rights reserved. Copyright © Scalable Systems, Inc. All rights reserved.

This product includes software developed by the Apache Software Foundation (http://www.apache.org/), and/or other software which is licensed under various versions
of the Apache License (the "License"). You may obtain a copy of these Licenses at http://www.apache.org/licenses/. Unless required by applicable law or agreed to in
writing, software distributed under these Licenses is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied. See the Licenses for the specific language governing permissions and limitations under the Licenses.

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 various versions of 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-2013, Daniel Stenberg, <[email protected]>. 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 and at http://www.eclipse.org/org/documents/edl-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:// 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- license-agreement; 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://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.net-snmp.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; http://benalman.com/about/license/; https://github.com/CreateJS/EaselJS/blob/master/src/easeljs/display/Bitmap.js;
http://www.h2database.com/html/license.html#summary; http://jsoncpp.sourceforge.net/LICENSE; http://jdbc.postgresql.org/license.html; http://
protobuf.googlecode.com/svn/trunk/src/google/protobuf/descriptor.proto; https://github.com/rantav/hector/blob/master/LICENSE; http://web.mit.edu/Kerberos/krb5-
current/doc/mitK5license.html; http://jibx.sourceforge.net/jibx-license.html; https://github.com/lyokato/libgeohash/blob/master/LICENSE; https://github.com/hjiang/jsonxx/
blob/master/LICENSE; and https://code.google.com/p/lz4/.

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 new BSD License (http://opensource.org/
licenses/BSD-3-Clause), the MIT License (http://www.opensource.org/licenses/mit-license.php), the Artistic License (http://www.opensource.org/licenses/artistic-
license-1.0) and the Initial Developer’s Public License Version 1.0 (http://www.firebirdsql.org/en/initial-developer-s-public-license-version-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 Copyright (c) 2013 Frank Balluffi and Markus Moeller. All rights reserved. Permissions and limitations regarding this software are subject
to terms of the MIT license.

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,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;
7,676,516; 7,720,842; 7,721,270; 7,774,791; 8,065,266; 8,150,803; 8,166,048; 8,166,071; 8,200,622; 8,224,873; 8,271,477; 8,327,419; 8,386,435; 8,392,460;
8,453,159; 8,458,230; and RE44,478, 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: MDM-OMG-100000-0001


Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Informatica Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Informatica My Support Portal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Informatica Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Informatica Product Availability Matrixes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Informatica Web Site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Informatica How-To Library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Informatica Knowledge Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Informatica Support YouTube Channel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Informatica Marketplace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Informatica Velocity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Informatica Global Customer Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

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


MDM Multidomain Edition Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Installation Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Designing the MDM Hub Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Chapter 2: Pre-Installation Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14


Read the Release Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Extract the Installer Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Verify License Key. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Verify the Minimum System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Set Environment Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Set the Operating System Locale. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Set Up the X Window Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Install and Configure Microsoft SQL Server for Distributed Transactions. . . . . . . . . . . . . . . . . . 17
Install ODBC Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Install and Configure WebLogic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Configure WebLogic to Use a Microsoft SQL Server Data Source. . . . . . . . . . . . . . . . . . . . 19
Create a WebLogic Cluster. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Configure WebLogic for Multiple MDM Hub Master Databases. . . . . . . . . . . . . . . . . . . . . . 20
Install and Configure Cleanse Engines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Choose a Timeline Granularity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Configure the Informatica Platform Properties File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Sample Properties File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Create an Installation Documentation Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Create an Informatica ActiveVOS Schema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

4 Table of Contents
Chapter 3: Hub Store Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Create the MDM Hub Master Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Create an Operational Reference Store. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Import the Metadata into the MDM Hub Master Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Import the Metadata into the Operational Reference Store. . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Chapter 4: Hub Server Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42


Installing the Hub Server in Graphical Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Installing the Hub Server in Console Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Installing the Hub Server in Silent Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Configuring the Properties File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Sample Properties File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Running the Silent Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Installing and Deploying the Hub Server on Nodes in the Cluster. . . . . . . . . . . . . . . . . . . . . . . 50

Chapter 5: Hub Server Post-Installation Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52


Copy the Installation Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Installation Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Installation Prerequisites Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Debug Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Post-Installation Setup Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Hub Server Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
WebLogic Server Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Verify the Version and Build Number. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Configure the Hub Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Deploying the Hub Server EAR File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Configuring the Logging Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Setting the Configuration Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Changing the WebLogic Server Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Running the Post Install Script Manually. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Manually Redeploying the Hub Server Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Manually Creating Data Sources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Manually Configuring JMS Message Queues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Step 1. Create a JMS Server and Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Step 2. Configure a Connection Factory for the Module. . . . . . . . . . . . . . . . . . . . . . . . . . 60
Step 3. Add Message Queues to the Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Step 4. Create a Subdeployment Queue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Step 5. Add a Message Queue Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Step 6. Add a Message Queue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Changing the Operational Reference Store User Password. . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Repackaging Custom JAR Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Restart WebLogic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Table of Contents 5
Configure JBoss Cache. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Configure Logging for Informatica Platform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Starting the Hub Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Registering an Operational Reference Store. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Adding MDM-ActiveVOS Users to the Application Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
ActiveVOS Web Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Configuring the ActiveVOS URNs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Chapter 6: Process Server Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69


Installing the Process Server in Graphical Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Installing the Process Server in Console Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Installing the Process Server in Silent Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Configuring the Properties File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Sample Properties File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Running the Silent Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Installing and Deploying the Process Server on Nodes in the Cluster. . . . . . . . . . . . . . . . . . . . 75

Chapter 7: Process Server Post-Installation Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . 77


Copy the Installation Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Installation Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Post-Installation Setup Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Process Server Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Debug Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Installation Prerequisites Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
WebLogic Server Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Verify the Version and Build Number. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Configure the Process Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Deploying the Process Server EAR File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Configuring the Process Server with Cleanse Engines. . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Configuring the Process Server to Delete Temporary Files. . . . . . . . . . . . . . . . . . . . . . . . 81
Configuring the Logging Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Setting the Configuration Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Running the PostInstallSetup Script Manually. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Manually Redeploying the Process Server EAR File . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Configure Process Server for Multithreading. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Configuring the Process Server for Multithreading. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Configuring Multiple Process Servers for Cleanse and Match Operations. . . . . . . . . . . . . . . . . . 84
Configuring Multiple Process Servers for Batch Processes. . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Configure Match Population. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Enabling Match Population. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Chapter 8: Resource Kit Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88


Setting Up the MDM Hub Sample Operational Reference Store. . . . . . . . . . . . . . . . . . . . . . . . 88

6 Table of Contents
Registering the Informatica MDM Hub Sample Operational Reference Store. . . . . . . . . . . . . . . . 90
Installing the Resource Kit in Graphical Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Installing the Resource Kit in Console Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Installing the Resource Kit in Silent Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Configuring the Properties File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Sample Properties File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Running the Silent Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Installing and Deploying the Resource Kit into a WebLogic Cluster. . . . . . . . . . . . . . . . . . . . . 100

Chapter 9: Troubleshooting the MDM Hub. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104


Troubleshooting the Installation Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Chapter 10: Uninstallation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106


Uninstallation Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Uninstalling the Hub Store. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Uninstalling the Process Server in Graphical Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Uninstalling the Process Server in Graphical Mode On UNIX. . . . . . . . . . . . . . . . . . . . . . 107
Uninstalling the Process Server in Graphical Mode On Windows. . . . . . . . . . . . . . . . . . . 107
Uninstalling the Hub Server in Graphical Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Uninstalling the Hub Server in Graphical Mode on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . 108
Uninstalling the Hub Server in Graphical Mode on Windows. . . . . . . . . . . . . . . . . . . . . . 108
Uninstalling the Resource Kit in Graphical Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Uninstalling the Resource Kit in Graphical Mode on UNIX. . . . . . . . . . . . . . . . . . . . . . . . 108
Uninstalling the Resource Kit in Graphical Mode on Windows. . . . . . . . . . . . . . . . . . . . . 109
Uninstalling the Process Server in Console Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Uninstalling the Hub Server in Console Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Uninstalling the Resource Kit in Console Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Manually Undeploying the Process Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Manually Undeploying the Hub Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Table of Contents 7
Preface
The Informatica MDM Multidomain Edition Installation Guide is written for database administrators, system
administrators, and implementers who are responsible for installing and setting up the Informatica MDM Hub.
This guide assumes that you have knowledge of operating systems, database environments, and your
application server.

Informatica Resources

Informatica My Support Portal


As an Informatica customer, you can access the Informatica My Support Portal 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, 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 [email protected]. 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 Product Availability Matrixes


Product Availability Matrixes (PAMs) indicate the versions of operating systems, databases, and other types
of data sources and targets that a product release supports. You can access the PAMs on the Informatica My
Support Portal at https://mysupport.informatica.com/community/my-support/product-availability-matrices.

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.

8
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.

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 [email protected].

Informatica Support YouTube Channel


You can access the Informatica Support YouTube channel at http://www.youtube.com/user/INFASupport. The
Informatica Support YouTube channel includes videos about solutions that guide you through performing
specific tasks. If you have questions, comments, or ideas about the Informatica Support YouTube channel,
contact the Support YouTube team through email at [email protected] or send a tweet to
@INFASupport.

Informatica Marketplace
The Informatica Marketplace is a forum where developers and partners can share solutions that augment,
extend, or enhance data integration implementations. By leveraging any of the hundreds of solutions
available on the Marketplace, you can improve your productivity and speed up time to implementation on
your projects. You can access Informatica Marketplace at http://www.informaticamarketplace.com.

Informatica Velocity
You can access Informatica Velocity at http://mysupport.informatica.com. Developed from the real-world
experience of hundreds of data management projects, Informatica Velocity represents the collective
knowledge of our consultants who have worked with organizations from around the world to plan, develop,
deploy, and maintain successful data management solutions. If you have questions, comments, or ideas
about Informatica Velocity, contact Informatica Professional Services at [email protected].

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.

The telephone numbers for Informatica Global Customer Support are available from the Informatica web site
at http://www.informatica.com/us/services-and-training/support-services/global-support-centers/.

Preface 9
CHAPTER 1

Installation Overview
This chapter includes the following topics:

• MDM Multidomain Edition Installation, 10


• Installation Tasks, 11
• Designing the MDM Hub Installation, 12

MDM Multidomain Edition Installation


MDM Multidomain Edition is a master data management solution that enhances data reliability and data
maintenance procedures. The MDM Multidomain Edition is also referred to as the MDM Hub. You can access
the MDM Hub features through the Hub Console.

The MDM Hub installation consists of the following components:

Hub Store
The Hub Store stores and consolidates business data for the MDM Hub. The Hub Store consists of the
following components:

• MDM Hub Master Database. Contains the MDM Hub environment configuration settings, such as user
accounts, security configuration, Operational Reference Store registry, and message queue settings.
The Hub Store consists of one or more MDM Hub Master Databases. You can access and manage
an Operational Reference Store from an MDM Hub Master Database. The default name of an MDM
Hub Master Database is CMX_SYSTEM.
• Operational Reference Store. Contains the master data, content metadata, and the rules to process
and manage the master data. You can configure separate Operational Reference Store databases for
different geographies, different organizational departments, and for the development and production
environments. You can distribute Operational Reference Store databases across multiple server
machines. The default name of an Operational Reference Store is CMX_ORS.

Hub Server

The Hub Server is a J2EE application that you must deploy on an application server. The Hub Server
processes data within the Hub Store and integrates the MDM Hub with external applications. The Hub
Server is the run-time component that manages core and common services for the MDM Hub.

Process Server

The Process Server processes batch jobs such as load, recalculate BVT, and re-validate, and performs
data cleansing and match operations. The Process Server is deployed in an application server

10
environment. The Process Server interfaces with the cleanse engine that you configure to standardize
and optimize data for match and consolidation.

Resource Kit
The Resource Kit is a set of samples, applications, and utilities to integrate the MDM Hub into your
applications and workflows. You can select the Resource Kit components that you want to install.

Informatica Platform
Comprises the Informatica services and Informatica clients that you use to perform Informatica platform
staging. The Informatica services consist of services to support the domain and application services to
perform tasks and manage databases. The Informatica domain is the administrative unit for the
Informatica environment. You use the clients to access the services in the domain. When you install the
Informatica platform as part of the MDM Hub installation, you install the Data Integration Service, Model
Repository Service, and Informatica Developer (the Developer tool).

Dynamic Data Masking

Dynamic Data Masking is a data security product that operates between the MDM Hub and a database
to prevent unauthorized access to sensitive information. Dynamic Data Masking intercepts requests sent
to the database and applies data masking rules to the request to mask the data before it is sent back to
the MDM Hub.

Informatica ActiveVOS
Informatica ActiveVOS is a business process management (BPM) tool. BPM tools support automated
business processes, including change-approval processes for data. When you combine Informatica
ActiveVOS with the MDM Hub and Informatica Data Director, you ensure that changes to master data
undergo a review-and-approval process before the data is included in the best version of the truth (BVT)
records. When you install ActiveVOS Server as part of the Hub Server installation, you install the
ActiveVOS Server, ActiveVOS Console, and Process Central. You also install predefined MDM
workflows, tasks, and roles.

Installation Tasks
You must complete the pre-installation tasks before you install the MDM Hub components. After the
installation, complete the post-installation tasks.

To install the MDM Hub, complete the following tasks:

1. Complete the pre-installation tasks. Complete the pre-installation tasks to ensure that you can
successfully run the installers for the Hub Server and the Process Server and create the Hub Store.
2. Install the MDM Hub components. Use the setup script provided with the MDM Hub distribution to create
the Hub Store. Use the MDM Hub installer to install the Hub Server and the Process Server.
3. Perform the post-installation configuration tasks. Test the database connections. Configure the Hub
Server and the Process Server to ensure that you can use the MDM Hub features.

Installation Tasks 11
Designing the MDM Hub Installation
Before you install the MDM Hub, you must decide how to set up the components of the Informatica MDM Hub
implementation. All the components of the MDM Hub implementation must have the same version. If you
have multiple versions of the MDM Hub, install each version in a separate environment.

You can install the MDM Hub in multiple environments, such as development, test, and production. The
requirements and priorities for each type of environment is unique. Therefore, the installation design differs
for each environment.

The following examples show some ways in which the MDM Hub components can be set up in an MDM Hub
implementation:

All components on a single host


You can install all the MDM Hub components on a single host machine. This environment simplifies
communication among the components.

The following figure shows all MDM Hub components installed on a single host:

Components distributed on multiple hosts


You can distribute the installation of the MDM Hub components on multiple host machines.

12 Chapter 1: Installation Overview


The following figure shows a distributed installation of the MDM Hub components:

Designing the MDM Hub Installation 13


CHAPTER 2

Pre-Installation Tasks
This chapter includes the following topics:

• Read the Release Notes, 14


• Extract the Installer Files, 14
• Verify License Key, 15
• Verify the Minimum System Requirements, 15
• Set Environment Variables, 16
• Set the Operating System Locale, 16
• Set Up the X Window Server, 16
• Install and Configure Microsoft SQL Server for Distributed Transactions, 17
• Install ODBC Driver, 18
• Install and Configure WebLogic, 18
• Install and Configure Cleanse Engines, 20
• Choose a Timeline Granularity, 21
• Configure the Informatica Platform Properties File, 22
• Create an Installation Documentation Directory, 34
• Create an Informatica ActiveVOS Schema, 34

Read the Release Notes


For updates to the installation and upgrade process, read the Informatica MDM Multidomain Edition Release
Notes. You can also find information about known and fixed limitations for the release.

Extract the Installer Files


The installer files are compressed and distributed.

Extract the installer files to a directory on your machine. Verify that the utility that you use for extraction also
extracts empty folders.

Download the MDM Hub compressed installation files from the Informatica Electronic Software Download site
to a directory on your machine. You can then extract the installer files.

14
If you intend to install the licensed version of ActiveVOS Server, download and extract the ActiveVOS Server
installer.

If you intend to install Informatica platform, download the Informatica platform compressed installation files to
a directory on your machine.

Verify License Key


Before you install the software, verify that you have the license key. 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.

Verify the Minimum System Requirements


Before you install the MDM Hub, verify that the machine meets the hardware and software requirements.

Verify that the machine meets the following minimum system requirements to install the MDM Hub
components:

RAM
Production environment: 12 GB

Development environment: 2 GB minimum, 4 GB recommended

Disk Space
1 GB

To verify that you have sufficient physical memory available to meet the run-time needs of the MDM Hub
components that you intend to install, use the following formula:
Total MDM Hub components run-time memory requirement = JDK JVM max heap size of the
application server + operating system native heap size

The hardware requirements for an MDM Multidomain Edition implementation are dependent on the data,
processing volumes, and business rules.

For more information about product requirements and supported platforms, see the Product Availability Matrix
on the Informatica My Support Portal:
https://mysupport.informatica.com/community/my-support/product-availability-matrices

Verify License Key 15


Set Environment Variables
Set the environment variables before you install the MDM Hub.

You must set JAVA_HOME and PATH environment variables to point to JDK 1.7.0_45 or later.

If you want to install Informatica platform on AIX or HP-UX, set the INFA_JDK_HOME environment variable
to point to the JDK directory.

Set the Operating System Locale


You must set the same operating system locale for the Hub Server, the Hub Store, and the Hub Console.

Choose one of the following locales for the MDM Hub components:

• en_US
• fr_FR
• de_DE
• ja_JP
• ko_KR
• zh_CN
• ES
• pt_BR

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 by 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.

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

Shell Command Example

C 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.

16 Chapter 2: Pre-Installation Tasks


If the X Window server does not support the font that the installer uses, the installer might display incorrect
labels on the buttons.

Install and Configure Microsoft SQL Server for


Distributed Transactions
You must install and configure Microsoft SQL Server before you create the Hub Store. Before you start
Microsoft SQL Server, ensure that you configure it for distributed transactions. The MDM Hub requires a
distributed transaction environment.

1. Install Microsoft SQL Server.


Note: Ensure that you specify mixed mode as the database engine authentication security mode.
2. To ensure that the Microsoft Distributed Transaction Coordinator (MS DTC) service starts when you start
Microsoft SQL Server, mark MS DTC as Automatic in the Service Manager.
3. Enable MS DTC for XA transactions.
4. Configure the JDBC distributed transactions component.
a. Download the Microsoft SQL Server JDBC driver from the Microsoft web site.
b. Extract the driver files to a directory on the machine.
c. Copy the sqljdbc_xa.dll file to the Binn directory of the machine on which Microsoft SQL Server is
installed.
The following table lists the server type that you can choose for XA transactions and the location of
the xa_install.sql file:

Server Type For XA Transaction sqljdbc_xa.dll Location

32-bit Microsoft SQL Server On UNIX. /enu/xa/x64


On Windows. \enu\xa\x64

64-bit Microsoft SQL Server on the x64 processor On UNIX. /enu/xa/x64


On Windows. \enu\xa\x64

d. Run the xa_install.sql script on Microsoft SQL Server.


The xa_install.sql script is in the xa directory of the Microsoft SQL Server JDBC driver. Run the
script as an administrator of the Microsoft SQL Server instance.
e. Verify that the script creates the SqlJDBCXAUser role in the Microsoft SQL Server master database.

For more information about how to install and configure Microsoft SQL Server for distributed transactions,
see the Microsoft SQL Server documentation.

Install and Configure Microsoft SQL Server for Distributed Transactions 17


Install ODBC Driver
If you install the application server on UNIX and Linux, you need an ODBC driver for Microsoft SQL Server so
that data sources can be created.

1. Download the ODBC driver for the operating system.


• On Linux. Download the Microsoft SQL Server ODBC driver from the Microsoft web site.
• On UNIX. Download the UNIX ODBC driver from the unixODBC Project home page.
2. Install the ODBC driver.

Install and Configure WebLogic


Install and configure WebLogic Server according to the instructions in the WebLogic documentation.

Note: Install the application server in the same time zone as the database server.

Before you install the Hub Server and the Process Server on the WebLogic application server, create
WebLogic domains. Use the WebLogic Administration console to create domains for the Hub Server and the
Process Server applications. For more information, see the WebLogic documentation.

Ensure that you perform the following configurations:

• If the operating system uses Internet Protocol version 6 (IPv6), you must add -
Djava.net.preferIPv4Stack=true to the script that is in the bin directory of the base domain:
On UNIX. startWebLogic.sh
On Windows. startWebLogic.cmd
• Add the following JVM option to the WebLogic startup script to force WebLogic and JGroups to use the
same bind address:
-Djgroups.bind_addr=<bind_addr>
where, <bind_addr> specifies the interface on which to receive and send messages.
• Set the maximum JVM heap size (-Xmx) to 4 GB or higher in the WebLogic startup script. Change the
following settings:
set JAVA_OPTS=%JAVA_OPTS% -server -Xms2048m -Xmx4096m -Xss2000k -XX:PermSize=256m -
XX:MaxPermSize=1024m
The -Xmx parameter must be three to four times the size of –XX:MaxPermSize and -XX:PermSize must
be one third or one fourth the size of -XX:MaxPermSize.
• Set the WLS_MEM_ARGS_64BIT memory variable to appropriate values in the following file:
On UNIX. <Domain Home Directory>/bin/setDomainEnv.sh
On Windows. <Domain Home Directory>\bin\setDomainEnv.cmd
For example:
WLS_MEM_ARGS_64BIT="-Xms256m -Xmx1024m -XX:PermSize512m"
• If you want to install Informatica platform, add the following option to JAVA_OPTIONS in the WebLogic
startup script:
-DUseSunHttpHandler=true
You set the option to true so that WebLogic uses the Sun HTTP Handler for the HTTP connection
between the MDM Hub and the Informatica platform.

18 Chapter 2: Pre-Installation Tasks


• Add the following option to JAVA_OPTIONS in the WebLogic startup script to set the log4j.xml file
configuration path:
-DFrameworksLogConfigurationPath="<Path to the log4j.xml file>"

Configure WebLogic to Use a Microsoft SQL Server Data Source


Configure WebLogic to use a Microsoft SQL Server data source. If you install the Cleanse Match Server on a
different machine from the one that runs the Hub Server, then on the Cleanse Match Server machine, create
data sources for each Operational Reference Store.

Contact Microsoft to get JDBC driver for the database configuration.

1. To configure WebLogic to use a Microsoft SQL Server data source, copy the Microsoft SQL Server
JDBC driver to the following directory:
On UNIX. <WebLogic_install_dir>/server/lib
On Windows. <WebLogic_install_dir>\server\lib
2. Add the path to the JDBC driver to the WEBLOGIC_CLASSPATH variable in the following file:
On UNIX. <WebLogic_install_dir>/common/bin/commEnv.sh
On Windows. <WebLogic_install_dir>\common\bin\commEnv.cmd
Note: Place the path to the JDBC driver before the path to other Weblogic Server libraries.

Create a WebLogic Cluster


You can choose to install the MDM Hub in a WebLogic clustered environment.

The following steps provide a high-level overview of the process to set up the WebLogic cluster. For more
information, see the WebLogic documentation.

1. Install WebLogic.
2. Create a domain called mydomain in the following directory:
On UNIX. /BEA/User_Projects/domain
On Windows. \BEA\User_Projects\domain
3. Use the following command to start the Admin server:
On UNIX. ./startWebLogic.sh
On Windows. startWebLogic.cmd
4. Log in to the WebLogic Administrator Console and create a machine, M1.
5. In machine M1, create the managed server MS1.
6. Add the managed server MS1 to machine M1.
7. On machine M1, navigate to the following directory:
On UNIX. <Domain_directory>/bin
On Windows. <Domain_directory>\bin
8. Use the following command to start the managed servers:
On UNIX.
./startManagedWebLogic.sh <machine name> http://<host of the admin server>:<port of
the admin server>

Install and Configure WebLogic 19


On Windows.
startManagedWebLogic.cmd <machine name> http://<host of the admin server>:<port of
the admin server>
9. Install WebLogic on another physical machine.
Note: Ensure that all machine in a cluster have the same version of WebLogic.
10. Create machine, M2.
11. In machine M2, create a domain called mydomain in the same directory structure as that you use for the
first machine.
On UNIX. /BEA/User_Projects/domain/
On Windows. \BEA\User_Projects\domain\
12. In machine M2, create the managed server MS2.
13. Add the managed server MS2 to machine M2.
14. Add the managed servers MS1 and MS2 to the cluster domain.
15. On machine M2, navigate to the following directory:
On UNIX. <Domain_directory>/bin
On Windows. <Domain_directory>\bin
16. Use the following command to start the managed servers:
On UNIX.
./startManagedWebLogic.sh <machine name> http://<host of the admin server>:<port of
the admin server>
On Windows.
startManagedWebLogic.cmd <machine name Ex:M1> http://<host of the admin
server>:<port of the admin server>

Configure WebLogic for Multiple MDM Hub Master Databases


If you want to configure more than one MDM Hub Master Database, you have to install an MDM Hub instance
for each MDM Hub Master Database. You must deploy each MDM Hub instance on a separate WebLogic
domain. Create as many WebLogic domains as the number of MDM Hub Master Databases and the MDM
Hub instances that you want to install.

Install and Configure Cleanse Engines


Install and configure a cleanse engine, such as Address Doctor, to use with the Process Server.

Verify that the Process Server operates properly. For instructions on how to configure the MDM Hub to
integrate with the cleanse engine, see the Informatica MDM Multidomain Edition Cleanse Adapter Guide.

20 Chapter 2: Pre-Installation Tasks


Choose a Timeline Granularity
Timeline graularity is the coarseness of effective periods, which is the period for which a version of a record
is valid. You can choose a timeline granularity that meets your business requirements. You can choose a
coarse timeline granularity, such as year, or the finest timeline granularity, which is seconds.

You can configure the timeline granularity of year, month, day, hour, minute, or seconds to specify effective
periods of data in the MDM Hub implementation. You can configure the timeline granularity that you need
when you create or update an Operational Reference Store.

Note: The timeline granularity that you configure cannot be changed. When you specify an effective period in
any timeline granularity, the system uses the database time locale for the effective periods. To create a
version that is effective for one timeline unit, the effective start date and the effective end date must be the
same.

The following table lists the timeline granularity that you can configure and the formats:

Timeline Granularity Timeline Format

Year yyyy

Month mm/yyyy

Day dd/mm/yyyy

Hour dd/mm/yyyy hh

Minute dd/mm/yyyy hh:mm

Second dd/mm/yyyy hh:mm:ss

Use one of the following timeline granularity options:

Year
When the timeline granularity is year, you can specify the effective period in the year format, such as
2010. An effective start date of a record starts at the beginning of the year and the effective end date
ends at the end of the year. For example, if the effective start date is 2013 and the effective end date is
2014, then the record would be effective from 01/01/2013 to 31/12/2014.

Month
When the timeline granularity is month, you can specify the effective period in the month format, such as
01/2013. An effective start date of a record starts on the first day of a month. The effective end date of a
record ends on the last day of a month. For example, if the effective start date is 02/2013 and the
effective end date is 04/2013, the record is effective from 01/02/2013 to 30/04/2013.

Day
When the timeline granularity is day, you can specify the effective period in the date format, such as
13/01/2013. An effective start date of a record starts at the beginning of a day, that is 12:00. The
effective end date of the record ends at the end of a day, which is 23:59. For example, if the effective
start date is 13/01/2013 and the effective end date is 15/04/2013, the record is effective from 12:00 on
13/01/2013 to 23:59 on 15/04/2013.

Hour
When the timeline granularity is hour, the effective period includes the year, month, day and hour, such
as 13/01/2013 15. An effective start date of a record starts at the beginning of an hour of a day. The

Choose a Timeline Granularity 21


effective end date of the record ends at the end of the hour that you specify. For example, if the effective
start date is 13/01/2013 15 and the effective end date is 15/04/2013 10, the record is effective from
15:00 on 13/01/2013 to 10:59 on 15/04/2013.

Minute
When the timeline granularity is minute, the effective period includes the year, month, day, hour, and
minute, such as 13/01/2013 15:30. An effective start date of a record starts at the beginning of a minute.
The effective end date of the record ends at the end of the minute that you specify. For example, if the
effective start date is 13/01/2013 15:30 and the effective end date is 15/04/2013 10:45, the record is
effective from 15:30:00 on 13/01/2013 to 10:45:59 on 15/04/2013.

Second
When the timeline granularity is second, the effective period includes the year, month, day, hour, minute,
and second, such as 13/01/2013 15:30:45. An effective start date of a record starts at the beginning of a
second. The effective end date ends at the end of the second that you specify. For example, if the
effective start date is 13/01/2013 15:30:55 and the effective end date is 15/04/2013 10:45:15, the record
is effective from 15:30:55:00 on 13/01/2013 to 10:45:15:00 on 15/04/2013.

Configure the Informatica Platform Properties File


If you want to install Informatica platform as part of the MDM Hub installation, create an Informatica platform
properties file. Specify the options for the installation in the properties file, and save the file with the name
SilentInput.properties.

1. Open a text editor.


2. Create an Informatica platform properties file in the text editor.
3. Configure the values of the installation parameters.
4. Save the properties file with the name SilentInput.properties.
Configure the following installation parameters:
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 an installation of Informatica. If the value is 1, the installer
upgrades a previous version of Informatica.

ENABLE_KERBEROS

Indicates whether to configure the Informatica domain to run on a network with Kerberos authentication.

To configure the Informatica domain to run on a network with Kerberos authentication, set the parameter
to 1.

SERVICE_REALM_NAME
Name of the Kerberos realm to which the Informatica domain services belong. The service realm name
and the user realm name must be the same.

22 Chapter 2: Pre-Installation Tasks


USER_REALM_NAME
Name of the Kerberos realm to which the Informatica domain users belong. The service realm name and
the user realm name must be the same.

KEYTAB_LOCATION
Directory where you store all keytab files for the Informatica domain. The name of a keytab file in the
Informatica domain must follow a format set by Informatica.

KRB5_FILE_LOCATION
Path and file name of the Kerberos configuration file. Informatica requires krb5.conf name for the
Kerberos configuration file.

SPN_SHARE_LEVEL
Indicates the service principal level for the domain. Set the property to one of the following levels:

• Process. The domain requires a unique service principal name (SPN) and keytab file for each node
and each service on a node. The number of SPNs and keytab files required for each node depends
on the number of service processes that run on the node. Recommended for production domains.
• Node. The domain uses one SPN and keytab file for the node and all services that run on the node.
The domain also requires a separate SPN and keytab file for all HTTP processes on the node.
Recommended for test and development domains.

Default is process.

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.

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.

Configure the Informatica Platform Properties File 23


KEY_DEST_LOCATION
Directory in which to store the encryption key on the node created during the installation.

PASS_PHRASE
Keyword to use to create an encryption key to secure sensitive data in the domain. The keyword must
meet the following criteria:

• From 8 to 20 characters long


• Includes at least one uppercase letter
• Includes at least one lowercase letter
• Includes at least one number
• Does not contain spaces

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 the parameter to 0. If CREATE_DOMAIN=0, you must set this
parameter to 1.

KEY_SRC_LOCATION
Directory that contains the encryption key on the master gateway node of the Informatica domain that
you want to join.

SSL_ENABLED

Enables or disables secure communication between services in the Informatica domain.

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 the property to
true if CREATE_DOMAIN=1. You must set the property to true if JOIN_DOMAIN=1.

SECURITY_DOMAIN_NAME
Name of the default security domain in the domain to which you join the node you create.

TLS_CUSTOM_SELECTION

Indicates whether to use SSL certificates that you provide to enable secure communication in the
Informatica domain.

To use SSL certificates that you provide, set this property to True.

NODE_KEYSTORE_DIR
Required if TLS_CUSTOM_SELECTION is set to True. Directory that contains the keystore files. The
directory must contain files named infa_keystore.jks and infa_keystore.pem.

NODE_KEYSTORE_PASSWD
Required if TLS_CUSTOM_SELECTION is set to True. Password for the keystore infa_keystore.jks.

NODE_TRUSTSTORE_DIR
Required if TLS_CUSTOM_SELECTION is set to True. Directory that contains the truststore files. The
directory must contain files named infa_truststore.jks and infa_truststore.pem.

NODE_TRUSTSTORE_PASSWD
Required if TLS_CUSTOM_SELECTION is set to True. Password for the infa_truststore.jks file.

24 Chapter 2: Pre-Installation Tasks


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
• DB2
• MSSQLServer

DB_UNAME
Database user account name for the domain configuration repository.

DB_PASSWD
Password for the database user account.

DB_SSL_ENABLED
Indicates whether the database for the domain configuration repository is secure. To create the domain
configuration repository in a secure database, set this parameter to True. If this parameter is set to True,
you must provide the JDBC connection string with the secure database parameters.

TRUSTSTORE_DB_FILE
Path and file name of the truststore file for the secure database.

TRUSTSTORE_DB_PASSWD

Password for the truststore file.

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

TRUSTED_CONNECTION

Indicates whether to connect to Microsoft SQL Server through a trusted connection. If the parameter is
empty, the installer uses Microsoft SQL Server authentication.

Set the parameter if you want to install on Windows.

DB_CUSTOM_STRING_SELECTION

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. If you create the domain configuration
repository on a secure database, set the parameter to 1.

DB_SERVICENAME

Required if DB_CUSTOM_STRING_SELECTION=0.

Database name for Microsoft SQL Server.

Configure the Informatica Platform Properties File 25


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

Name of the domain.

The default domain name is Domain_<MachineName>. The name must not exceed 128 characters and
must be 7-bit ASCII. It cannot contain a space or any of the following characters: ` % * + ; " ?

DOMAIN_HOST_NAME

Host name of the machine that hosts the node.

Note: Do not use localhost. The host name must explicitly identify the machine.

NODE_NAME

Required if CREATE_DOMAIN=1.

Name of the node to create on the 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.

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

DOMAIN_CNFRM_PSSWD
Enter the password again to confirm.

JOIN_NODE_NAME

Required if JOIN_DOMAIN=1.

Name of the node that you are joining to the domain. The node name is not the host name for the
machine.

26 Chapter 2: Pre-Installation Tasks


JOIN_HOST_NAME

Required if JOIN_DOMAIN=1.

Host name of the machine on which to create the node that you are joining to the domain. The node host
name cannot contain the underscore (_) character.

Note: Do not use localhost. The host name must explicitly identify the machine.

JOIN_DOMAIN_PORT

Required if JOIN_DOMAIN=1.

Port number of the gateway node of the domain that 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 dynamic port numbers that you can assign to the application service
processes that run on the node.

MAX_PORT

You can set this parameter if ADVANCE_PORT_CONFIG=1.

Highest port number in the range of dynamic port numbers that you can assign to the application service
processes that run on the node.

TOMCAT_PORT

You can set this parameter if ADVANCE_PORT_CONFIG=1.

Port number that the Service Manager uses 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 that Informatica Administrator uses. 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.

On Windows, specify whether to run the Informatica service under the same user account as the account
used for installation.

Set the following properties if you want to run the Informatica service under a different user account:

Configure the Informatica Platform Properties File 27


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:


Domain Name\User Account

The user account must have the Act as operating system permission.

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

Sample Properties File


The following example shows the contents of the sample silentInput.properties file:
# Use the sample file SilentInput.properties to install Informatica services without
user interaction.
# Use the 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.6.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

# Provide Kerberos Network Authentication parameters:

#Set this property to 1 if you are Enabling Kerberos


ENABLE_KERBEROS=0

#Provide Service realm name.


SERVICE_REALM_NAME=

#Provide User realm name.


USER_REALM_NAME=
#provide KeyTab location.
KEYTAB_LOCATION=

28 Chapter 2: Pre-Installation Tasks


#Provide Kerberos configuration file location.
KRB5_FILE_LOCATION=

# The SPN_SHARE_LEVEL property determines whether the service principal level for the
domain is Node or Process.
# Value NODE Use Node Level. Configure the domain to share SPNs and keytab
files on a node.
# Value PROCESS Use Process Level. Configure the domain to use a unique service
principal name (SPN) and keytab file for each node and each service on a node.

SPN_SHARE_LEVEL=

# 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.
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

#Please Specify the site key Destination location


KEY_DEST_LOCATION=c:\Informatica\9.6.1\isp\config\keys

#set the property to Pass Phrase, this field needs to set only for CREATE DOMAIN case
PASS_PHRASE_PASSWD=

# The JOIN_DOMAIN property determines whether to join the node to another domain

Configure the Informatica Platform Properties File 29


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

# Set the property to the site key source location and this needs to set only for JOIN
DOMAIN case
KEY_SRC_LOCATION=c:\temp\siteKey

# 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 property SECURITY_DOMAIN_NAME represents the LDAP name for the Kerberos
enabled domain
# Set the property if JOIN_DOMAIN=1 and ENABLE_KERBEROS=1

SECURITY_DOMAIN_NAME=

#################################################
#Provide TLS information for domain. Set TLS_CUSTOM_SELECTION equals to true if you
want domain level TLS option.

TLS_CUSTOM_SELECTION=false
################################
#Below fields are only required when you set TLS_CUSTOM_SELECTION=true
NODE_KEYSTORE_DIR=c:\temp
NODE_KEYSTORE_PASSWD=
NODE_TRUSTSTORE_DIR=c:\temp
NODE_TRUSTSTORE_PASSWD=

# 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 the database types (case-sensitive): MSSQLServer.

DB_TYPE=MSSQLServer

# 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.

DB_PASSWD=UserPassword

# The DB_SSL_ENABLED property represents whether the database is in SSL mode or not.
#Set the property to "true" if you want to enable secure communication.
# Also if this property is set to true then DB_CUSTOM_STRING_SELECTION property must be
set to 1 to use
#only custom string option property DB_CUSTOM_STRING which should include the following
secure DB parameters:
#EncryptionMethod=SSL;HostNameInCertificate=;ValidateServerCertificate=

DB_SSL_ENABLED=false

30 Chapter 2: Pre-Installation Tasks


# The TRUSTSTORE_DB_FILE and TRUSTSTORE_DB_PASSWD properties to be set only if enable
secure communication
#for the DB property i.e DB_SSL_ENABLED=true
# Set the TRUSTSTORE_DB_FILE property to the location of the trust store file for the DB
# Set the TRUSTSTORE_DB_PASSWD as a password of the trust store file for the DB

TRUSTSTORE_DB_FILE=

TRUSTSTORE_DB_PASSWD=

# 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.
# In Create domain scenario ,when CREATE_DOMAIN=1
# Set the property if DB_TYPE=MSSQLServer and you are installing on Windows.

# Set TRUSTED_CONNECTION=0 if DB_TYPE is set to a database type other than


MSSQLServer or if you install 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.

# In join node scenario, when JOIN_DOMAIN=1


# Set this value to empty,for all cases.

TRUSTED_CONNECTION=

# 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

Configure the Informatica Platform Properties File 31


# 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=

# 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 128 characters.

DOMAIN_PSSWD=

# 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=

32 Chapter 2: Pre-Installation Tasks


# 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.
# 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.

Configure the Informatica Platform Properties File 33


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.
# 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.
#######

Create an Installation Documentation Directory


Create a directory to store copies of installation files, such as the validation results, environment reports,
database debug logs, and log files.

For example, you can create the directory install_doc. If you need to troubleshoot the installation, you can
create an archive file of the installation documentation directory and send it to Informatica Global Customer
Support for analysis.

Create an Informatica ActiveVOS Schema


Before you run the Hub Server installer, you need to create the ActiveVOS database schema. To create the
schema, you run a script.

1. Open a command prompt.


2. Navigate to the following location in the distribution directory:
On UNIX. <distribution directory>/database/bin

34 Chapter 2: Pre-Installation Tasks


On Windows. <distribution directory>\database\bin
3. Run the following command:
On UNIX. sip_ant.sh create_bpm
On Windows. sip_ant.bat create_bpm
4. Answer the prompts that appear.
Note: The prompt displays default text in brackets. Press Enter to use the default value and go to the
next prompt.
Enter database type. (ORACLE, MSSQL, DB2)
Database type, which must be the same as the database type selected for the MDM Hub Master
Database and the Operational Reference Stores. Specify MSSQL.

Enter ActiveVOS user name. [AVOS]


User name of the ActiveVOS Server administrative user.

Enter ActiveVOS user password.


Password of the administrative user.

Enter ActiveVOS collation name.


Name of the ActiveVOS database.

Enter the hostname for ActiveVOS database. [localhost]


Name of the machine that hosts the database.

Enter the path to the ActiveVOS database.


Path to the database location.

Enter the DBA user name. [sa]


User name of the SA user.

Enter the DBA password.


Password of the SA user account.
5. After you create the schema, review sip_ant.log in the following directory:
On UNIX. <distribution directory>/database/bin
On Windows. <distribution directory>\database\bin
The sip_ant.log file logs any errors that might occur when you run the sip_ant script to create the
ActiveVOS database schema.

Create an Informatica ActiveVOS Schema 35


CHAPTER 3

Hub Store Installation


This chapter includes the following topics:

• Create the MDM Hub Master Database, 36


• Create an Operational Reference Store, 37
• Import the Metadata into the MDM Hub Master Database, 38
• Import the Metadata into the Operational Reference Store, 39

Create the MDM Hub Master Database


After you install Microsoft SQL Server, you must create a MDM Hub Master Database. The default name of
the MDM Hub Master Database is CMX_SYSTEM.

Note: If you change the folder names in the distribution directory, metadata import fails.

1. Open a command prompt.


2. Navigate to the following location in the distribution directory:
On UNIX. <distribution directory>/database/bin
On Windows. <distribution directory>\database\bin
3. Run the following command:
On UNIX. sip_ant.sh create_system
On Windows. sip_ant.bat create_system
4. Answer the prompts that appear.
Note: The prompt displays default text in brackets. Press Enter to use the default value and go to the
next prompt.
Enter database type. (ORACLE, MSSQL, DB2)
Database type. Specify MSSQL.

Enter the MDM Hub Master Database user name. [cmx_system]


Name of the MDM Hub Master Database user. Default is cmx_system.

Enter the database host name. [localhost]


Name of the machine that hosts the database. Default is localhost.

36
Enter the database port number. [1433]
Port number that the database listener uses. Default is 1433.

Enter CMX_SYSTEM database path. ["C:\MSSQLDATA"]


Path to the Microsoft SQL Server data file store enclosed in double quotation marks.
Note: If you create the Operational Reference Store from a remote Windows machine, do not use
spaces in the database path.

Enter CMX_SYSTEM database collation name. (Latin1_General_CI_AS)


Collation name to set a collation sequence for the Operational Reference Store.

Enter the Master Database user password


Password to access the MDM Hub Master Database.

Enter locale name from the list: de, en_US, fr, ja, ko, zh_CN. [en_US]
Operating system locale.

Enter the DBA user name. [sa]


Default is sa.

Enter the DBA password.


Password of the SA user account.
5. After you create the MDM Hub Master Database, review sip_ant.log in the following directory:
On UNIX. <distribution directory>/database/bin
On Windows. <distribution directory>\database\bin
The sip_ant.log file logs any errors that might occur when you run the sip_ant script to create the
MDM Hub Master Database.

Create an Operational Reference Store


After you create the MDM Hub Master Database, you must create an Operational Reference Store. The
default name of the Operational Reference Store is CMX_ORS.

Note: If you change the folder names in the distribution directory, metadata import fails.

1. Open a command prompt.


2. Navigate to the following location in the distribution directory:
<distribution directory>\database\bin
3. Run the following command:
On UNIX. sip_ant.sh create_ors
On Windows. sip_ant.bat create_ors
4. Answer the prompts that appear.
Note: The prompt displays default text in brackets. Press Enter to use the default value and go to the
next prompt.

Create an Operational Reference Store 37


Enter database type. (ORACLE, MSSQL, DB2)
Database type. Specify MSSQL.

Enter the Operational Reference Store database host name. [localhost]


Name of the machine that hosts the database. Default is localhost.

Enter the Operational Reference Store database port number. [1433]


Port number that the database listener uses. Default is 1433.

Enter the Operational Reference Store database user name. [cmx_ors]


Name of the Operational Reference Store database user. Default is cmx_ors.

Enter CMX_ORS database path. ["C:\MSSQLDATA"]


Path to the Microsoft SQL Server data file store enclosed in double quotation marks.
Note: If you create the Operational Reference Store from a remote Windows machine, do not use
spaces in the database path.

Enter CMX_ORS database collation name. (Latin1_General_CI_AS)


Collation name to set a collation sequence for the Operational Reference Store.

Enter the Operational Reference Store database user password.


Password of the Operational Reference Store database user.

Enter locale name from the list: de, en_US, fr, ja, ko, zh_CN. [en_US]
Operating system locale. Default is en_US.

Enter the DBA user name. [sa]


Default is sa.

Enter the DBA password.


Password of the SA user account.
5. After you create the Operational Reference Store, review sip_ant.log in the following directory:
On UNIX. <distribution directory>/database/bin
On Windows. <distribution directory>\database\bin
The sip_ant.log file logs any errors that might occur when you run the sip_ant script to create the
Operational Reference Store.

Import the Metadata into the MDM Hub Master


Database
After you create the MDM Hub Master Database, import the initial metadata into the MDM Hub Master
Database. The initial metadata includes repository tables and other objects that the MDM Hub requires in the
Hub Store.

Note: If you change the folder names in the distribution directory, metadata import fails.

1. Open a command prompt.


2. Navigate to the following location in the distribution directory:

38 Chapter 3: Hub Store Installation


On UNIX. <distribution directory>/database/bin
On Windows. <distribution directory>\database\bin
3. Run the following command:
On UNIX. sip_ant.sh import_system
On Windows. sip_ant.bat import_system
4. Answer the prompts that appear.
Note: The prompt displays default text in brackets. Press Enter to use the default value and go to the
next prompt.
Enter database type. (ORACLE, MSSQL, DB2)
Database type. Specify MSSQL.

Enter the MDM Hub Master Database name. [cmx_system]


Name of the MDM Hub Master Database that you created. Default is cmx_system.

Enter the database host name. [localhost]


Name of the machine that hosts the database. Default is localhost.

Enter the database port number. [1433]


Port number that the database listener uses. Default is 1433.

Connect URL. [jdbc:sqlserver://localhost:1433]


Connect URL for Microsoft SQL Server. Default is jdbc:sqlserver://localhost:1433.

Enter the MDM Hub Master Database user password.


Password to access the MDM Hub Master Database.

Enter a locale name from the list: de, en_US, fr, ja, ko, zh_CN. [en_US]
Operating system locale. Default is en_US.
5. After you import the initial metadata, review the seed.log file in the following directory for errors:
On UNIX. <distribution directory>/database/bin/mssql
On Windows. <distribution directory>\database\bin\mssql
6. Review sip_ant.log in the following directory:
On UNIX. <distribution directory>/database/bin
On Windows. <distribution directory>\database\bin
The sip_ant.log file logs any errors that might occur when you run the sip_ant script to import
metadata into the MDM Hub Master Database.

Import the Metadata into the Operational Reference


Store
After you create the Operational Reference Store, import the initial metadata into the Operational Reference
Store. The initial metadata includes repository tables and other objects that the MDM Hub requires in theHub
Store.

Import the Metadata into the Operational Reference Store 39


Note: If you change the folder names in the distribution directory, metadata import fails.

1. Open a command prompt.


2. Navigate to the following location in the distribution directory:
On UNIX. <distribution directory>/database/bin
On Windows. <distribution directory>\database\bin
3. Run the following command:
On UNIX. sip_ant.sh import_ors
On Windows. sip_ant.bat import_ors
4. Answer the prompts that appear.
Note: The prompt displays default text in brackets. Press Enter to use the default value and go to the
next prompt.
Enter database type. (ORACLE, MSSQL, DB2)
Database type. Specify MSSQL.

Enter the Operational Reference Store database host name. [localhost]


Name of the machine that hosts the database. Default is localhost.

Enter the Operational Reference Store database port number. [1433]


Port number that the database listener uses. Default is 1433.

Enter the Operational Reference Store database user name. [cmx_ors]


Name of the Operational Reference Store database. Default is cmx_ors.

Connect URL. [jdbc:sqlserver://<host name>:<port>]


Connect URL for Microsoft SQL Server. Default is jdbc:sqlserver://<host name>:<port>.

Enter the Operational Reference Store database user name (schema name). [cmx_ors]
User name of the Operational Reference Store database user. Default is cmx_ors.

Enter the Operational Reference Store database user password.


Password to access the Operational Reference Store.

Enter a locale name from the list: de, en_US, fr, ja, ko, zh_CN. [en_US]
Operating system locale. Default is en_US.

Enter integer code of Operational Reference Store Timeline Granularity: Year 5, Month 4, Day 3, Hour 2, Minute 1,
Second 0. [3]
Timeline displays data change events of business entities and their relationships. Timeline is
enabled by default for relationship base objects. Timeline granularity is the timeline unit that you use
to specify effective periods of data in the MDM Hub implementation. Choose a timeline granularity
that meets your business requirements. Default is 3.
Note: The timeline granularity that you configure cannot be modified later.
For more information about timeline, see the Informatica MDM Multidomain Edition Configuration
Guide.
5. After you import the initial metadata, review the seed.log file in the following directory for errors:
On UNIX. <distribution directory>/database/bin/mssql
On Windows. <distribution directory>\database\bin\mssql

40 Chapter 3: Hub Store Installation


6. Review sip_ant.log in the following directory:
On UNIX. <distribution directory>/database/bin
On Windows. <distribution directory>\database\bin
The sip_ant.log file logs any errors that might occur when you run the sip_ant script to import
metadata into the Operational Reference Store.

Import the Metadata into the Operational Reference Store 41


CHAPTER 4

Hub Server Installation


This chapter includes the following topics:

• Installing the Hub Server in Graphical Mode, 42


• Installing the Hub Server in Console Mode, 45
• Installing the Hub Server in Silent Mode, 46
• Installing and Deploying the Hub Server on Nodes in the Cluster, 50

Installing the Hub Server in Graphical Mode


You can install the Hub Server in graphical mode.

You must use the same user name to install the Hub Server and the Process Server. If you install the Hub
Server and the Process Server on the same machine, the users who install them must belong to the same
UNIX group.

1. Start the application server.


2. Open a command prompt and navigate to the Hub Server installer in the distribution directory. By default
the installer is in the following directory:
On UNIX. <distribution directory>/<operating system name>/mrmserver
On Windows. <distribution directory>\windows\mrmserver
3. Run the following command:
On UNIX. ./hub_install.bin
On Windows. hub_install.exe
4. Select the language for the installation, and then click OK.
The Introduction window appears.
5. Click Next.
The License Agreement window appears.
6. Select the I accept the terms of the License Agreement option, and then click Next.
The Choose an Install Folder window appears.
7. Select the location of the Hub Server installation.
• To choose the default location, click Next.
• To enter a path, type the path to the installation folder, and click Next.

42
Note: The installation fails if you specify a path that has spaces in the directory or folder names.
• To choose another location, click Choose, and then click Next.
On UNIX, the Choose Link Folder window appears.
On Windows, the Choose Shortcut Folder window appears.
8. On UNIX, choose a link folder or select the option to not create links and click Next. On Windows, select
the location to create a product icon or select the option not to create a product icon.
9. Click Next.
The Enter the location of the license file window appears.
10. Click Choose to select a license file, and click Next.
The Application Server window appears.
11. Select WebLogic, and then click Next.
The WebLogic Application Server Home window appears.
12. Configure the following WebLogic Server settings:
a. Choose a path to the WebLogic domain installation directory for the domain you want to use for the
MDM Hub. Click Next.
The WebLogic Application Server Login window appears.
b. Enter WebLogic Server login information.
The following table describes the login parameter fields:

Field Name Description

Host Name of the host computer that has the


WebLogic installation.

Server Name of the WebLogic Server instance in the


domain on which WebLogic is deployed.

User Name Name of the user for the WebLogic installation.

Password Password that corresponds to the WebLogic user.

Port Number Port number on which the WebLogic Server is


listening.

13. Click Next.


The Database Selection window appears.
14. Select Microsoft SQL 2012, and click Next.
The Microsoft SQL Server Database Information window appears.
15. Specify the configuration parameters to create the J2EE data source, and click Next.

Installing the Hub Server in Graphical Mode 43


The following table describes the configuration parameter fields:

Field Name Description

Server Name of the server.

Port Port number of the MDM Hub Master Database.

Database Name Name of the MDM Hub Master Database.

DBO Username Database owner user name of the MDM Hub Master Database.

DBO Password Database owner password of the MDM Hub Master Database.

The Install ActiveVOS window appears.

16. If you want to install the bundled, licensed version of Informatica ActiveVOS, select Yes and perform the
following substeps. Otherwise, select No. Click Next.

a. On the ActiveVOS Installer page, click Choose and browse to the ActiveVOS_Server installation file
in the distribution package. Click Next.
b. On the Choose ActiveVOS Installation Folder page, accept the default installation path or specify a
preferred location. Click Next.
c. On the Database Information page, enter the details that you specified when you created the
ActiveVOS database schema. Click Next.
d. On the Application Server Web URL page, accept the default URL or specify the URL that you want
to use to call ActiveVOS web services. Click Next.
The post installation setup script uses the URL to call ActiveVOS web services, deploy the
predefined MDM workflows to ActiveVOS, and create the URN mapping.
17. Select one of the following Informatica platform installation options:
• Yes. Install Informatica platform.
• No. Does not install Informatica platform.
18. If you select Yes in step 17, click Choose and browse to the following Informatica platform file locations:
• Installation response file
• Installation archive file
19. Select one of the following post installation setup script options:
• Yes, run the script during this installation. Runs the post installation script during the installation.
• No, I will run it later. Allows you to manually run the post installation script later.
The Deploy window appears.
20. Click Next.
The Pre-Installation Summary window appears.
21. After the Pre-Installation Summary window displays the options you want, click Install to start the
installation process.
When the installation completes, the Install Complete window appears.
22. Click Done to exit the Hub Server installer.

44 Chapter 4: Hub Server Installation


Installing the Hub Server in Console Mode
You can install the Hub Server in console mode on UNIX.

1. Start the application server.


2. Navigate to the following directory in the MDM Hub distribution:
On UNIX. <distribution directory>/<operating system name>/mrmserver
3. Run the following command from the command prompt:
./hub_install.bin -i console
4. Enter the number of the locale you want to choose for the installation, and then press Enter.
The introduction information about the installation appears.
5. Press Enter.
The license agreement appears.
6. Read the License Agreement. Type Y to accept the terms of the license agreement, or type N if you do
not want to accept the license agreement and want to exit the installation program.
7. Press Enter.
If you entered Y in the preceding step, information about the installation folder appears.
8. Choose a folder for the Hub Server installation.
• To choose the default folder, press Enter.
• To change the path, type the absolute path of the installation folder, and press Enter.
9. Confirm the location of the installation folder. Type Y to confirm the installation folder, or type N to
change the installation folder.
10. Press Enter.
A list of link location options appears.
11. Enter the number of a link location option.
The prompt for the license file location appears.
12. Enter the absolute path of the license file, and press Enter.
A list of application server options appears.
13. Enter the number for the application server that you want to select, and press Enter.
The application server information appears.
14. Configure the WebLogic settings.
a. Specify the path to the WebLogic domain in which you want to install the Hub Server, and press
Enter.
The prompts for the WebLogic application server login information appears.
b. Enter the host name, server name, user name, password, and listener port for the WebLogic Server,
or accept the default values, and press Enter.
15. Press Enter.
The database selection prompt appears.
16. Enter the number corresponding to Microsoft SQL 2012, and press Enter.
17. Specify the settings for the Microsoft SQL 2012 database to which you want to connect.
Press Enter to accept the default values, or replace the default values with the correct values.

Installing the Hub Server in Console Mode 45


The following table describes the prompts:

Prompt Description

Server Name of the server.

Port Port number of the MDM Hub Master Database.

Database Name Name of the MDM Hub Master Database.

DBO Username Database owner user name of the MDM Hub Master Database.

DBO Password Database owner password of the MDM Hub Master Database.

18. Press Enter.


19. If you want to install the bundled, licensed version of the ActiveVOS Server, press Enter for Yes.
Otherwise, type 2 for No and press Enter.
If you selected Yes, the installer prompts you to provide information about your ActiveVOS installation.
a. Specify the location of the ActiveVOS Server installation file.
b. Specify the location where you want to install the ActiveVOS Server.
c. Enter information about the ActiveVOS database that you specified when you created the
ActiveVOS schema.
d. Specify the URL that you want to use to call MDM and ActiveVOS web services.
20. Press Enter.
The Informatica platform installation prompt appears.
21. If you want to install the Informatica platform, press Enter for Yes. Otherwise, type 2 for No and press
Enter.
The prompts for the Informatica platform installation response file and archive file locations appear.
22. Enter the locations of the Informatica platform installation response file and archive file, and press Enter.
The summary of the installation choices appears.
23. Choose whether you want to run the postInstallSetup script as part of the installation, or run it
manually later.
24. Verify the information in the pre-installation summary. If the information is correct, press Enter to start
the installation.
The Hub Server is installed according to the configuration information you provide. When the process is
complete, the installation complete message appears.
25. Press Enter to exit the installer.

Installing the Hub Server in Silent Mode


You can install the Hub Server without user interaction in silent mode. You might want to perform a silent
installation if you need multiple installations, or if you need to install on a machine cluster. A silent installation
does not show any progress or failure messages.

46 Chapter 4: Hub Server Installation


Before you run the silent installation for the Hub Server, you must configure the properties file for the silent
installation. The installer reads the file to determine the installation options. The silent installation process
might complete successfully even if you provide incorrect settings, such as an incorrect application server
path or port. You must ensure that you provide correct settings in the properties file.

Copy the Hub Server installation files to the hard disk on the machine where you plan to install the Hub
Server. 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 the installer requires. You can
customize the sample properties file to specify the options for the installation. Then run the silent installation.

The silent installer does not validate the settings in the properties files. You must ensure that you specify
correct settings and verify them before you run the silent installer.

1. Find the silentInstallServer_sample.properties file in the following directory:


On UNIX. /silent_install/mrmserver
On Windows. \silent_install\mrmserver
After you customize the file, re-save it. You can rename the file and put it anywhere on the machine.
Note: In the silent properties file, slash and backslash are special characters. You must enter two of
each of these characters when you enter information in the file, such as when you enter an installation
path. For example, to enter the path to the server directory, you must enter \\u1\\infamdm\\hub\
\server.
2. Create a backup copy of the silentInstallServer_sample.properties file.
3. Use a text editor to open the file and change the values of the installation parameters.
4. Save the properties file with a new name such as silentInstallServer.properties.
The following table describes the installation parameters that you can modify:

Property Name Description

INSTALLER_UI Specifies the type of installation. Set to silent.

USER_INSTALL_DIR Directory where you want to install Hub Server.


For example, C\:\
\<infamdm_install_directory>\\hub\
\server.

SIP.LICENSE.PATH Path to the Informatica license file.

SIP.LICENSE.FILENAME License file name. Set to siperian.license.

SIP.AS.CHOICE Name of the application server. Specify WebLogic.

SIP.AS.HOME The path to the WebLogic installation directory.

SIP.APPSERVER.HOST Host name such as localhost.

SIP.APPSERVER.SERVER Admin Server name such as AdminServer.

Installing the Hub Server in Silent Mode 47


Property Name Description

SIP.APPSERVER.USERNAME User name to access WebLogic.

SIP.APPSERVER.PASSWORD Password to access WebLogic.

WEBLOGIC.AS.PORT Application server port number.

SIP.DB.CHOICE Name of the database server. Specify MSSQL.

SIP.DB.SERVER Host name of the database server.

SIP.DB.PORT Database server port number.

SIP.DB.SCHEMA_NAME Schema name of the MDM Hub Master Database.

SIP.DB.USER Database user name.

SIP.DB.PASSWORD Password of the user used to connect to the system


schema.

SIP.DB.DBNAME Name of the Microsoft SQL Server master database.

AVOS.INSTALL Specifies whether you want to install Informatica


ActiveVOS or not.
If you want to install Informatica ActiveVOS, set the
property to Yes. Otherwise, set to No.

AVOS_INSTALLER_PATH The path to the ActiveVOS Server installer.

AVOS_INSTALL_DIR The path to the location where you want to install the
ActiveVOS Server.

AVOS.DB.SERVER Name of the machine that hosts the ActiveVOS


database.

AVOS.DB.PORT Port number that the database listener uses.

AVOS.DB.DBNAME Name of the ActiveVOS database. Default is avos.

AVOS.DB.USER User name of the ActiveVOS Server administrative


user. Default is avos.

AVOS.DB.PASSWORD Password of the administrative user.

SIP.APPSERVER.WEB.URL URL to the application server in the following format:


http://[server]:[port]

INSTALL.PLATFORM.YES Specifies whether you want to install Informatica


platform or not.
If you want to install Informatica platform, set the
property to 1. Otherwise, set to 0.

INFA.PLATFORM.ZIP Path to the compressed Informatica platform installer.

48 Chapter 4: Hub Server Installation


Property Name Description

INFA.PLATFORM.PROPERTIES Path to the Informatica platform installation properties


file that you create.

RUN_DEPLOYMENT_FLAG Runs the postInstallSetup script as part of the silent


installation. Set to 1 if you want to run postInstallSetup.
Set to 0 if you do not want to run postInstallSetup at
the end of the silent installation.

Sample Properties File


The following example shows the contents of the sample silentInstallServer_sample.properties file:
## Command to run silent install
## For Windows: hub_install.exe -f <property_file>
## For Unix: hub_install.bin -f <property_file>

INSTALLER_UI=silent

## Hub Server Install directory.


USER_INSTALL_DIR=C\:\\infamdm\\hub\\server

## License path and filename


SIP.LICENSE.PATH=C\:\\
SIP.LICENSE.FILENAME=siperian.license

## Properties for WebLogic application server


SIP.AS.CHOICE="WebLogic"
SIP.AS.HOME=C\:\\bea\\user_projects\\domains\\base_domain
SIP.APPSERVER.HOST=localhost
SIP.APPSERVER.SERVER=AdminServer
SIP.APPSERVER.USERNAME=weblogic
SIP.APPSERVER.PASSWORD=weblogic
WEBLOGIC.AS.PORT=7001
## Properties for MSSQL server
SIP.DB.CHOICE="MSSQL"
SIP.DB.SERVER=localhost
SIP.DB.PORT=1433
SIP.DB.SCHEMA_NAME=CMX_SYSTEM
SIP.DB.USER=CMX_SYSTEM
SIP.DB.PASSWORD=!!cmx!!
SIP.DB.DBNAME=CMX_SYSTEM

## Do you want to install ActiveVOS (Yes/No)


AVOS.INSTALL=Yes
## Path to ActiveVOS Installer (ActiveVOS_Server_windows_9.2.4.exe for Windows or
ActiveVOS_Server_unix_9.2.4.sh for Linux/UNIX)
AVOS_INSTALLER_PATH=/export/home/mdmqa/software/builds/ActiveVOS/9.2.4/GA/
ActiveVOS_Server_unix_9.2.4.sh
## ActiveVOS server install directory
AVOS_INSTALL_DIR=/export/home/mdmqa/infamdmsl/avos/server

## Database type is the same as for HUB (There is no ability to set a different
database type for ActiveVOS)
## MSSQL connection data
#AVOS.DB.SERVER=localhost
#AVOS.DB.PORT=1433
#AVOS.DB.DBNAME=avos
#AVOS.DB.USER=avos
#AVOS.DB.PASSWORD=!!cmx!!

## If you want to install Informatica Platform, set to 1


## If you DO NOT want to install Informatica Platform, set to 0
INSTALL.PLATFORM.YES=1

Installing the Hub Server in Silent Mode 49


## Path to the Informatica Platform installer (zip or tar file)
INFA.PLATFORM.ZIP=C\:\\961HF1_Server_Installer_winem-64t.zip
## For UNIX: INFA.PLATFORM.ZIP=/export/home/user/961HF1_Server_Installer_linux-x64.tar

## Path to silent installer properties file


INFA.PLATFORM.PROPERTIES=C\:\\SilentInput.properties

## If you want to run postInstallSetup as a part of silent install, then set following
property.
## set RUN_DEPLOYMENT_FLAG to 1 if you want to run postInstallSetup
## or set RUN_DEPLOYMENT_FLAG to 0 if you do not want to run postInstallSetup
RUN_DEPLOYMENT_FLAG=1

Running the Silent Installer


After you configure the properties file, you can start the silent installation.

1. Ensure that the application server is running.


2. Open a command window.
3. Run the following command:
On UNIX. ./hub_install.bin -f <location_of_silent_properties_file_for_hub_server>
On Windows. hub_install.exe -f <location_of_silent_properties_file_for_hub_server>
The silent installer runs in the background. The process can take a while. If you ran the postInstallSetup
script for the Hub Server as part of the silent installation, check the postinstallSetup.log files to verify that
the installation was successful.
The log file is available in the following directory:
On UNIX. <infamdm_install_directory>/hub/server/logs/
On Windows. <infamdm_install_directory>\hub\server\logs\

Installing and Deploying the Hub Server on Nodes in


the Cluster
If you have a clustered environment, install the Hub Server on the Admin Server and on all nodes of the
cluster to which you must deploy the Hub Server application.

If the cluster has two Managed Servers that run on host1 and host2, and use RMI ports 8001 and 8002, then
the properties in cmxserver.properties can have the following values:

• cmx.appserver.hostname=host1,host2
• cmx.appserver.rmi.port=8001,8002
Where, the host name and port number of the first server are host1 and 8001, the host name and port
number of the second server are host2 and 8002.

Note: Separate the port numbers by a comma with no space between them. The order of host names and
port numbers must be the same.

50 Chapter 4: Hub Server Installation


You can install and deploy the Hub Server after you start the cluster.

1. Start the Hub Server installer on all nodes of the cluster.


Run the following command to start the Hub Server installer:
On UNIX. ./hub_install.bin -DSIPERIAN_INSTALL_PREREQ_VALIDATION=false
On Windows. hub_install.exe -DSIPERIAN_INSTALL_PREREQ_VALIDATION=false
2. Click No when the installer prompts you to run the postInstallSetup script to deploy the application.
3. When the installer prompts for the WebLogic listener port, enter the managed server ports for any node
in the cluster if the cluster is set up with the development cluster IP address.
Use the DNS name and the cluster port if you use the production cluster IP address.
4. After the installation, open the cmxserver.properties file on all nodes in the cluster. The
cmxserver.properties file is in the following directory:
On UNIX. <infamdm_install_directory>/hub/server/resources
On Windows. <infamdm_install_directory>\hub\server\resources
5. Change the following properties in the cmxserver.properties file on all nodes in the cluster:

Property Description

cmx.appserver.hostname Specify machine names of the cluster servers.

cmx.appserver.rmi.port Specify RMI port numbers.

6. Run the following command to repackage the Hub Server EAR file:
On UNIX.
cd <infamdm_install_directory>/hub/server/bin
./sip_ant.sh repackage
On Windows.
cd <infamdm_install_directory>\hub\server\bin
sip_ant.bat repackage
7. Open the WebLogic Server console, and manually create JMS queues. For more information about how
to create JMS queues, see the Informatica MDM Multidomain Edition Configuration Guide.
Note: When you create JMS queues for the MDM Hub, ensure that you select a target server that you
can migrate. When you configure the JMS module, make the target “All servers in the cluster.” For more
information see the WebLogic documentation.
8. Open the WebLogic Server console, and manually create the connection pools and data sources for the
MDM Hub Master Database and Operational Reference Stores.
9. Manually deploy the Hub Server EAR through the WebLogic Server console.
Note: Select the cluster server name to which you must deploy the application.
If you use the development cluster IP, you can access the Hub Server through the nodes in the cluster. If you
use the production cluster IP, you can use the cluster names to access the Hub Server. After you start the
Hub Server application, the EJB clustering distributes requests between the managed servers and manages
any failover.

Installing and Deploying the Hub Server on Nodes in the Cluster 51


CHAPTER 5

Hub Server Post-Installation


Tasks
This chapter includes the following topics:

• Copy the Installation Log Files, 52


• Verify the Version and Build Number, 55
• Configure the Hub Server, 56
• Running the Post Install Script Manually, 57
• Manually Redeploying the Hub Server Application, 58
• Manually Creating Data Sources, 58
• Manually Configuring JMS Message Queues, 60
• Changing the Operational Reference Store User Password, 62
• Repackaging Custom JAR Files, 63
• Restart WebLogic, 63
• Configure JBoss Cache, 63
• Configure Logging for Informatica Platform, 64
• Starting the Hub Console, 65
• Registering an Operational Reference Store, 65
• Adding MDM-ActiveVOS Users to the Application Server, 67
• ActiveVOS Web Applications, 67
• Configuring the ActiveVOS URNs, 67

Copy the Installation Log Files


The installation log files are useful for troubleshooting the Hub Server installation process. Copy the log files
to the installation documentation directory. Informatica Global Customer Support might request copies of the
log files if you contact them regarding installation issues.

Installation Log File


The installation log file contains information about the installed files.

52
The following table describes the properties of the installation log file:

Property Description

File Name Informatica_MDM_Hub_Server_Install_<ti


mestamp>.xml

Location On UNIX.
<infamdm_install_directory>/hub/
server/UninstallerData/Logs
On Windows. <infamdm_install_directory>
\hub\server\UninstallerData\Logs

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.

Installation Prerequisites Log File


The installation prerequisites log file contains information about the prerequisite checks that the installer
performs.

The following table describes the properties of the installation prerequisites log file:

Property Description

File Name installPrereq.log

Location On UNIX.
<infamdm_install_directory>/hub/
server/Logs
On Windows. <infamdm_install_directory>
\hub\server\Logs

Usage Get information about the prerequisite checks


performed by the installer.

Contents Logs of prerequisite validation checks.

Debug Log File


The installer writes actions and errors to the debug log file.

Copy the Installation Log Files 53


The following table describes the properties of the debug log file:

Property Description

File Name infamdm_installer_debug.txt

Location On UNIX.
<infamdm_install_directory>/hub/
server/
On Windows. <infamdm_install_directory>
\hub\server\

Usage Get information about the choices that are made during
installation.

Contents Detailed summary of actions performed by the installer.

Post-Installation Setup Log File


The post-installation log file contains information about the post-installation process.

The following table describes the properties of the post-installation setup log file:

Property Description

File Name postInstallSetup.log

Location On UNIX.
<infamdm_install_directory>/hub/
server/logs
On Windows. <infamdm_install_directory>
\hub\server\logs

Usage Get information about the post-installation actions


performed by the installer and get information about
the errors in the post-installation process.

Contents Summary of actions performed by the installer during


the post-installation process.

Hub Server Log File


The Hub Server log file contains information about Hub Server operations.

54 Chapter 5: Hub Server Post-Installation Tasks


The following table describes the properties of the Hub Server log file:

Property Description

File Name cmxserver.log

Location On UNIX.
<infamdm_install_directory>/hub/
server/logs
On Windows. <infamdm_install_directory>
\hub\server\logs

Usage Get information about the Hub Server operations.

Contents Summary of the Hub Server operations.

WebLogic Server Log Files


The WebLogic Server log file contains information about WebLogic processes.

The following table describes the properties of the WebLogic Server log files:

Property Description

File Name access.log


<weblogic_server>.log
<weblogic_domain>.log

Location On UNIX. <Weblogic_domain>/servers/


<Weblogic_server>/logs
On Windows. <Weblogic_domain>\servers
\<Weblogic_server>\logs

Usage Get information about server processes such as


messages and transactions.

Contents Contains message processing status, JMS connection


status, transaction details, java exceptions, and file
access details.

Verify the Version and Build Number


You must ensure that the correct version and build number of the Hub Server is installed.

Perform one of the following steps to verify the Hub Server version and build number:

• Verify the version and build number in the manifest.mf JAR entry in the siperian-mrm-server.ear file.
The siperian-mrm-server.ear file is in the following directory:
On UNIX. <infamdm_install_directory>/hub/server
On Windows. <infamdm_install_directory>\hub\server
• Verify the version and build number in the versionInfo.xml file that is in the following directory:

Verify the Version and Build Number 55


On UNIX. <infamdm_install_directory>/hub/server/conf
On Windows. <infamdm_install_directory>\hub\server\conf
• On UNIX. Run versionInfo.sh that is in the following directory:
<infamdm_install_directory>/hub/server/bin
On Windows. Run versionInfo.bat that is in the following directory:
<infamdm_install_directory>\hub\server\bin

Configure the Hub Server


After you install the Hub Server, you need to configure it. You can configure logging settings, and change
application server and Hub Server settings.

Deploying the Hub Server EAR File


You must deploy the Hub Server EAR file on the same machine on which you install the Hub Server.

The Hub Server application must be able to find the Hub Server installation from which you deploy it.
Therefore, do not transfer the EAR file for deployment on another machine. For example, if you install the
Hub Server on a test machine and then deploy the EAR file on the production machine, the application on
production machine cannot find the installation for configuration information such as logging.

Configuring the Logging Settings


You can configure the Hub Server for logging. Specify the configuration settings for logging in the log4j.xml
file.

1. Open log4j.xml in the following directory:


On UNIX. <infamdm_install_directory>/hub/server/conf
On Windows. <infamdm_install_directory>\hub\server\conf
2. Set the value for the following category names:
• com.siperian
• com.delos
• com.informatica
Set the value of category names to DEBUG for the most detailed logging, INFO for less detailed logging,
and ERROR for the least detailed logging. The default is INFO.
3. Set the value for the Threshold parameters to DEBUG.
4. Save and close the log4j.xml file.

Setting the Configuration Properties


You can configure the Hub Server properties in the cmxserver.properties file.

56 Chapter 5: Hub Server Post-Installation Tasks


1. Open cmxserver.properties in the following directory:
On UNIX. <infamdm_install_directory>/hub/server/resources
On Windows. <infamdm_install_directory>\hub\server\resources
2. Set the Hub Server properties.
The following text shows a sample configuration of the cmxserver.properties file:
cmx.home=C:\infamdm\hub\server
cmx.server.masterdatabase.type=MSSQL
cmx.appserver.type=weblogic
cmx.appserver.rmi.port=7001
cmx.appserver.naming.protocol=t3
cmx.appserver.soap.connector.port=
jnlp.initial-heap-size=128m
jnlp.max-heap-size=512m
cmx.server.datalayer.cleanse.execution=SERVER
cmx.server.datalayer.cleanse.working_files.location=C:\infamdm\hub\server\logs
cmx.server.datalayer.cleanse.working_files=LOCAL
3. Restart the Hub Server application to reload the settings in the cmxserver.properties file.

Changing the WebLogic Server Settings


If you want to change any of the WebLogic Server settings that you specify during the installation process,
change them after the installation.

1. Open build.properties in the following directory:


On UNIX. <infamdm_install_directory>/hub/server/bin
On Windows. <infamdm_install_directory>\hub\server\bin
2. Change the WebLogic Server configuration settings.
3. Save and close the build.properties file.
4. Run the postInstallSetup script.
5. Restart the WebLogic Server application server.

Running the Post Install Script Manually


If you skipped the post install script during installation, you must run the post install script manually.

1. Open a command prompt.


2. Navigate to the PostInstallSetup script in the following directory:
On UNIX. <infamdm installation directory>/hub/server
On Windows. <infamdm installation directory>\hub\server

Running the Post Install Script Manually 57


3. Run the following command:
On UNIX. ./postInstallSetup.sh -Dweblogic.password=<Weblogic_Password> -
Ddatabase.password=<DB_Password>
Note: If you include the exclamation mark (!) in your password, you must include a backslash before the
exclamation mark. For example, if your password is !!cmx!!, enter the password as follows: \!\!cmx\!\!
On Windows. postInstallSetup.bat -Dweblogic.password=<Weblogic_Password> -
Ddatabase.password=<DB_Password>

Manually Redeploying the Hub Server Application


You can use the postInstallSetup script to deploy or redeploy the Hub Server application to WebLogic Server.
However, you can also use the default application server tool to deploy the Hub Server application.

Ensure that you deploy the Hub Server application from the Hub Server installation directory.

1. Use the WebLogic Server Administration Console to undeploy the siperian-mrm.ear file.
2. Use the WebLogic Server Administration Console to deploy the siperian-mrm.ear file.
For more information, see the WebLogic Server documentation.

Manually Creating Data Sources


If you want to configure multiple Process Servers, manually configure data sources. Also, manually configure
data sources if you need to troubleshoot issues. For example, create data sources manually if the automated
queue creation process fails.

1. Configure WebLogic to use a data source.


a. Contact the database provider to get the JDBC driver for the database configuration.
b. Copy the JDBC driver to the following directory:
On UNIX. <WebLogic_install_dir>/server/lib
On Windows. <WebLogic_install_dir>\server\lib
c. Add the path to the JDBC driver to the WEBLOGIC_CLASSPATH variable in the following file:
On UNIX. <WebLogic_install_dir>/common/bin/commEnv.sh
On Windows. <WebLogic_install_dir>\common\bin\commEnv.cmd
Note: Place the path to the JDBC driver before the path to other WebLogic Server libraries.
2. Start the WebLogic Administration Console.
3. Click Services > Data Sources.
The Summary of Data Sources page appears.
4. Click New and select Generic Data Source.
The JDBC Data Sources Properties page appears.
5. Provide the following JDBC data source properties, and click Next:

58 Chapter 5: Hub Server Post-Installation Tasks


Name
Name for the JDBC data source.

On Microsoft SQL Server. <Microsoft SQL Server host name>-<operational reference store name>

JNDI Name
JNDI path to which the JDBC data source is bound.

On Microsoft SQL Server. jdbc/siperian-<Microsoft SQL Server host name>-<operational reference


store name>-ds

Database Type
Database that you want to connect to.

The Database Driver page appears.


6. Select the database driver that you want to use to connect to the database, and click Next.
MS SQL Server Driver (Type 4 XA) Versions: 2005 or later
The Transaction Options page appears.
7. Click Next.
The Connection Properties page appears.
8. Enter values for the following connection properties:
Database Name
Name of the database that you want to connect to.

Host Name
DNS name or IP address of the server that hosts the database.

Port
Port on which the database server listens for connections requests.

Database User Name


Database user name that you want to use for each connection in the data source.

Password
Password of the database user account.

Confirm Password
Password of the database user account.
9. Click Next.
The Test Database Connection page appears.
10. Review the connection properties, and enter a table name such as C_REPOS_DB_RELEASE in the
Test Table Name field.
11. Click Test Configuration.
If the test is unsuccessful, you must update the values in the Connection Properties page and then
retry the connection until successful.
12. Click Next.
The Select Targets page appears.
13. Select AdminServer as the server on which you want to deploy the data source.
14. Click Finish.

Manually Creating Data Sources 59


15. In the Change Center of the Administration Console, click Activate Changes.
16. Restart WebLogic to ensure that all changes are activated.

Manually Configuring JMS Message Queues


If you need to troubleshoot issues, you can manually configure JMS message queues. For example, you
might need to manually create message queues if the automated queue creation process fails or if the
queues are accidentally dropped after installation.

The Services Integration Framework (SIF) uses a message-driven bean on the JMS message queue to
process incoming asynchronous SIF requests. Configure the message queue and the connection factory for
the application server that you use for the MDM Hub implementation. When you configure a JMS message
queue, you also create a connection factory.

To manually configure the JMS message queue, perform the following tasks:

1. Create a JMS server and module.


2. Create a connection factory for the module.
3. Add JMS message queues to the module.
4. Create a subdeployment queue.
5. Add a message queue server.
6. Add a message queue.

Step 1. Create a JMS Server and Module


Use the Weblogic Administration Console to create a JMS message queue. Create a JMS server and a
module for the message queue.

1. Start the WebLogic Console, and click Lock&Edit.


2. Navigate to Services > Messaging > JMS Servers.
3. Create a JMS Server with the name SiperianJMSServer, and click Next.
4. Select the server name in the Target list, and click Finish.
5. Navigate to Services > Messaging > JMS Modules.
6. Create a JMS Module with the name SiperianModule, and click Next.
7. Select the Target Server check box.
8. Click Next, and then click Finish.

Step 2. Configure a Connection Factory for the Module


Create and configure a connection factory for the module that you created.

1. Navigate to the SiperianModule that you created in “Step 1. Create a JMS Server and Module” on page
60.
2. Click New under Summary of Resources.
3. Choose Connection Factory, and click Next.

60 Chapter 5: Hub Server Post-Installation Tasks


4. Specify siperian.mrm.jms.xaconnectionfactory for both the name and the JNDI name, and click
Next.
5. Select Target Server, and click Finish.
The siperian.mrm.jms.xaconnectionfactory connection factory is created.
6. Under Configuration, go to the siperian.mrm.jms.xaconnectionfactory connection factory that you
created.
7. Click Transactions.
8. Select the XA Connection Factory Enabled check box.
9. Click Save.

Step 3. Add Message Queues to the Module


You can add JMS message queues to the module that you created.

1. Navigate to SiperianModule, and click New under Summary of Resources.


2. Choose Queue, and click Next.
3. Specify siperian.sif.jms.queue for both the name and the JNDI name, and click Next.
4. Choose the JMS Server that you created in “Step 1. Create a JMS Server and Module” on page 60, and
click Finish.
5. Click Activate Changes.

Step 4. Create a Subdeployment Queue


After you add JMS message queues to the module that you created, create a subdeployment queue.

1. Under Summary of Resources, go to SiperianModule, and click New.


2. Choose Queue, and click Next.
3. Click the Create a new Subdeployment button.
4. Verify that the Subdeployment Name is siperian.sif.jms.queue, and click OK.
5. Specify siperian.sif.jms.queue for both the name and the JNDI name, and click Next.
6. Choose the JMS Server that you created, and click Finish.
7. Click Activate Changes.

Step 5. Add a Message Queue Server


You must add a message queue server to the MDM Hub implementation before you add a message queue.

1. Start the Hub Console.


2. Click Message Queues under the Configuration workbench.
3. Click Write Lock > Acquire Lock.
4. Right-click on the middle pane of the Message Queues tool, and then click Add Message Queue
Server.
The Add Message Queue Server dialog box appears.
5. Enter values for the following fields:

Manually Configuring JMS Message Queues 61


Connection Factory Name
Name of the connection factory. Specify siperian.mrm.jms.xaconnectionfactory.

Display Name
Name of the message queue server that must appear in the Hub Console. Specify
Siperian.Mrm.Jms.Xaconnectionfactory.
6. Click OK.
The message queue server is added.

Step 6. Add a Message Queue


You can add a message queue to a message queue server.

1. Start the Hub Console.


2. Click Message Queues under the Configuration workbench.
3. Click Write Lock > Acquire Lock.
4. Right-click the message queue server in the middle pane of the Message Queues tool, and then click
Add Message Queue.
The Add Message Queue dialog box appears.
5. Enter values for the following fields:
Queue Name
Name of the message queue. Specify siperian.sif.jms.queue.

Display Name
Name of the message queue that must appear in the Hub Console. Specify
Siperian.Sif.Jms.Queue.
6. Click OK.
The message queue is added to the message queue server.
7. In the right pane, select the Use with message triggers option.
8. Click Test.
The result of the message queue test appears.

Changing the Operational Reference Store User


Password
After you install the Hub Server, you can change the password for the Operational Reference Store. If you
change the password for the Operational Reference Store, perform the following tasks:

1. Change the password for the Operational Reference Store user.


2. Set the same password in the data source on the application server.
3. Register the schema with the same user name and password.

62 Chapter 5: Hub Server Post-Installation Tasks


Repackaging Custom JAR Files
If you have custom JAR files, repackage the JAR files in the siperian-mrm-server.ear file after you install
the Hub Server.

1. Run the following command to create a directory named EAR:


On UNIX.
cd <infamdm_install_directory>/hub/server/lib
mkdir ear
On Windows.
cd <infamdm_install_directory>\hub\server\lib
mkdir ear
2. Run the following command to copy each custom JAR file to the EAR directory that you create in the
preceding step:
On UNIX.
copy <original_location_of_custom_jar_file>/<custom_JAR_filename>.jar ear
On Windows.
copy <original_location_of_custom_jar_file>\<custom_JAR_filename>.jar ear
3. Run the following command to repackage the EAR file:
On UNIX.
cd <infamdm_install_directory>/hub/server/bin
sip_ant.sh repackage
On Windows.
cd <infamdm_install_directory>\hub\server\bin
sip_ant.bat repackage

Restart WebLogic
The installation process enables the AnonymousAdminLookupEnabled method of the WebLogic Server. The
AnonymousAdminLookupEnabled method must be enabled for the registration of the Operational Reference
Store. If you do not restart WebLogic Server after you install the Hub Server, the Operational Reference
Store fails.

Configure JBoss Cache


You can configure JBoss Cache to handle caching requirements. Modify the JBoss cache properties for
tuning performance.

Change the jbossCacheConfig.xml file in the following location to configure JBoss Cache:

On UNIX. <infamdm_install_dir>/hub/server/resources/jbossCacheConfig.xml

On Windows. <infamdm_install_dir>\hub\server\resources\jbossCacheConfig.xml

Change the following properties in the jbossCacheConfig.xml file:

Repackaging Custom JAR Files 63


lockAcquisitionTimeout
Increase the value of the property to 60000 or higher, to ensure that the Hub Server acquires a cache
object lock.

sync replTimeout
Increase the value of the property to 30000 or higher, to ensure that the Hub Server acquires a cache
object lock.

stateRetrieval timeout
Increase the value of the property to 60000, to ensure initial state retrieval.

clustering
Set up the clustering property for a clustered environment.

Set the clusterName attribute to use the same cluster name for all the members of a single cluster.

jgroupsConfig
Set UDP configurations for the property to ensure that there is no conflict between different cluster
members.

Set the mcast_addr=<multicast_address> attribute to use the same value for all the members of a
single cluster. Use different values for different clusters, or non-clustered MDM Hub Servers on the same
network.

Set the mcast_port=<multicast_port> attribute to use the same value for all the members of a single
cluster. Use different values for different clusters, or non-clustered MDM Hub servers on the same
network.

eviction
Change the eviction time for ReposObjects and DataObjects if there is enough memory and these
objects need to remain in memory for a longer duration.

Change the eviction time as shown in the following sample:


<region name="/ReposObjects">
<property name="timeToLive" value="86400000" /> <!—24 hours is the minimum
required-->
</region>
<region name="/DataObjects">
<property name="timeToLive" value="86400000" /> <!—24 hours is the minimum
required-->
</region>

Configure Logging for Informatica Platform


If you Installed Informatica platform, configure the MDM Hub to log Informatica platform processes.

1. Open the log4j.xml file from the following directory:


On UNIX. <infamdm_install_directory>/hub/server/conf
On Windows. <infamdm_install_directory>\hub\server\conf
2. Add the following lines to the log4j.xml file.
<category name="com.informatica.mdm.platform">
<priority value="ALL"/>
</category>

64 Chapter 5: Hub Server Post-Installation Tasks


<appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender">
<param name="Threshold" value="ALL"/>
</appender>
3. Save and close the log4j.xml file.

Starting the Hub Console


Start the Hub Console to access the MDM Hub. Use an HTTP connection to start the Hub Console.

Ensure that you have a user name and password set up before you start the Hub Console.

1. Open a browser window and enter one of the following URLs:


http://<MDM Hub host>:<port>/cmx/
where <MDM Hub host> is the local MDM Hub host and port is the port number. Check with your
administrator for the correct port number.
The Hub Console launch window appears.
2. Click Launch.
Java Web Start loads.
Note: The first time you launch the Hub Console from a client machine, Java Web Start downloads
application files.
The MDM Hub Login dialog box appears.
3. Enter a user name and password.
4. Click OK.
The Change database dialog box appears.
5. Select the target database.
The target database is the MDM Hub Master Database.
6. Select a language from the list, and click Connect.
The Hub Console user interface appears in the language that you select. If you need to change the
language in which the Hub Console user interface appears, restart the Hub Console with the language of
your choice.

Registering an Operational Reference Store


After you create an Operational Reference Store, you must register it. Register an Operational Reference
Store with a single MDM Hub Master Database. You can register an Operational Reference Store through the
Hub Console.

Note: When you register an Operational Reference Store in a clustered environment, manually create the
data sources and connection pools for the Operational Reference Stores.

1. Start the Hub Console.


The Change database dialog box appears.
2. Select the MDM Hub Master database, and click Connect.

Starting the Hub Console 65


3. Start the Databases tool under the Configuration workbench.
4. Click Write Lock > Acquire Lock.
5. Click the Register database button.
The Informatica MDM Hub Connection Wizard appears and prompts you to select the database type.
6. Select the Microsoft SQL Server database type, and click Next.
7. Configure connection properties for the database.
a. In the Connection Properties page, specify the connection properties, and then click Next.
The following table lists and describes the connection properties:

Property Description

Database Display Name for the Operational Reference Store that must appear in the Hub
Name Console.

Machine Identifier Prefix given to keys to uniquely identify records from the Hub Store instance.

Database hostname IP address or name of the server that hosts the Microsoft SQL Server
database.

Port Port of the Microsoft SQL Server database. The default is 1433.

Schema Name Name of the Operational Reference Store.

Password Password associated with the user name for the Operational Reference Store.

Dynamic Data Not required. Do not populate this field, because the value that you provide is
Masking host not used.

DDM connection Optional. URL to connect to the Dynamic Data Masking application. The URL is
URL similar to the URL that you use to connect to the database, except that the
Dynamic Data Masking application URL uses the Dynamic Data Masking host
name and port number.

b. In the Connection Properties page, specify the connection properties, and then click Next.
c. Review the summary, and specify additional connection properties.
The following table lists additional connection properties that you can configure:

Property Description

Connection URL Connect URL. The Connection Wizard generates the connect URL by
default.

Create data source after Select to create the data source on the application server after
registration registration.

8. Click Finish.
The Registering Database dialog box appears.
9. Click OK.
The MDM Hub registers the Operational Reference Store.

66 Chapter 5: Hub Server Post-Installation Tasks


10. Select the Operational Reference Store that you registered, and click the Test database connection
button to test the database settings.
The Test Database dialog box displays the result of the database connection test.
11. Click OK.
The Operational Reference Store is registered, and the connection to the database is tested.

Adding MDM-ActiveVOS Users to the Application


Server
To finish the integration of the ActiveVOS Server with the MDM Hub, you need to set up container-based
authentication in the application server and add users.

For step-by-step instructions on configuring container-based authentication, see the How-To Library
document Container-based Authentication for MDM-ActiveVOS in WebLogic
https://mysupport.informatica.com/docs/DOC-13237 .

Note: You need to use the same user names, passwords, and roles in the MDM Hub, ActiveVOS, and the
application server. Ensure that the password complies with the password standard for the application server.

ActiveVOS Web Applications


When you install the bundled, licensed version of the ActiveVOS Server, you are also licensed to use two
ActiveVOS web applications. After you add users to the application server container, you can use these
applications.

You use the web applications for different purposes:

ActiveVOS Console
Administrators use the ActiveVOS Console to manage deployed processes, the alerting system, and
endpoint locations. You can also configure the engine for performance monitoring and management.

ActiveVOS Central
Business users can use ActiveVOS Central to manage tasks, requests, and reports. However, in
general, business users use an Informatica Data Director (IDD) application to manage tasks because
they can open the entities to review from the IDD Task Inbox.

For more information about the web applications, see the Informatica ActiveVOS documentation.

Configuring the ActiveVOS URNs


The ActiveVOS Server has two predefined uniform resource names (URNs) that it uses to direct to web
pages. You need to update the URL in the URN mappings to use the host name and port number where the
ActiveVOS Server runs.

Adding MDM-ActiveVOS Users to the Application Server 67


1. Launch the ActiveVOS Console. In a browser, type the following URL, substituting the correct host name
and port number:
http://[host]:[port]/activeVOS
2. In the ActiveVOS Console, on the Home page, click Administration > Configure Server > URN
Mappings.
3. For the following URNs, update the paths to reflect the correct host name and port number:

URN URL Path

ae:internal-reporting http://[host]:[port]/activevos/internalreports

ae:task-inbox http://[host]:[port]/activevos-central/avc

4. Verify that urn:MDMHost:InfaMDM is mapped to:


http://[host]:[port]/cmx/services/SifService

68 Chapter 5: Hub Server Post-Installation Tasks


CHAPTER 6

Process Server Installation


This chapter includes the following topics:

• Installing the Process Server in Graphical Mode, 69


• Installing the Process Server in Console Mode, 71
• Installing the Process Server in Silent Mode, 72
• Installing and Deploying the Process Server on Nodes in the Cluster, 75

Installing the Process Server in Graphical Mode


You can install the Process Server in graphical mode.

On UNIX, use the same user name that you used to install the Hub Server for the Process Server. If you
install the Hub Server and the Process Server on the same machine, the users who install them must belong
to the same UNIX group.

On UNIX, if you install the Process Server and the Hub Server on the same machine, use the operating
system user account that you use for the Hub Server to install the Process Server. Use the root user to install
the Process Server only when the root user account is already used for the Hub Server.

1. Start the application server.


2. Open a command prompt and navigate to the Process Server installer in the distribution directory. By
default the installer is in the following directory:
On UNIX. <distribution directory>/<operating system name>/mrmcleanse
On Windows. <distribution directory>\windows\mrmcleanse
3. Run the following command:
On UNIX. hub_cleanse_install.bin
On Windows. hub_cleanse_install.exe
4. Select the language for the installation, and then click OK.
The Introduction window appears.
5. Click Next.
The License Agreement window appears.
6. Select the I accept the terms of the License Agreement option, and then click Next.
The Choose Install Folder window appears.
7. Select the location of the Process Server installation.

69
• To choose the default location, click Next.
• To choose another location, click Choose, and then click Next.
Important: Process Server fails to load if the total length of the path exceeds 256 characters or includes
spaces in the directory or folder names.
On UNIX, the Choose Link Folder window appears.
On Windows, the Choose Shortcut Folder window appears.
8. Select a location for the product icons, and click Next.
The Enter Location of License File window appears.
9. Click Choose to select a license file, and click Next.
The Application Server window appears.
10. Select WebLogic, and then click Next.
The WebLogic Application Server Home window appears.
11. Configure the following WebLogic Server settings:
a. Choose a path to the WebLogic domain installation directory for the domain you want to use for the
MDM Hub. Click Next.
The WebLogic Application Server Login window appears.
b. Enter values for the login parameters.
The following table describes the login parameters:

Parameter Description

Host Name of the host computer on which WebLogic is


installed.

Server Name of the WebLogic Server instance in the


domain on which WebLogic is deployed. For
example, AdminServer.

User Name Name of the user for the WebLogic installation.

Password Password that corresponds to the WebLogic user.

Port Number Port number on which the WebLogic Server is


listening.

12. Configure cleanse engine settings for the cleanse engine you use.
• If you use Address Doctor, specify the Configuration file and Parameter file locations and the
Correction Type parameter.
• If you use Business Objects DQ XI, specify the Host, Port, and Sub File parameters for the Business
Objects DQ XI cleanse engine.
13. Click Next.
The Deploy window appears.
14. To run the post install script during the installation, select Yes, run the script during this installation.
To manually run the post install script, select No, I will run it later.
15. Click Next.
The Pre-Installation Summary window appears.

70 Chapter 6: Process Server Installation


16. After the summary window displays the options you want, click Install to start the installation process.
When the installation completes, the Install Complete window appears.
17. Select Yes, restart my system to restart the system, or select No, I will restart the system myself to
restart it later.
18. Click Done to exit the Process Server installer.
After installation, you must perform additional configuration for the cleanse engine according to the
instructions in the Informatica MDM Multidomain Edition Cleanse Adapter Guide.

Installing the Process Server in Console Mode


You can install the Process Server in console mode on UNIX.

Note: Do not use the root user when you install the Process Server on RedHat Linux. The root user does not
have a .profile, which InstallAnywhere requires. Instead, create and use a separate user profile to install the
Process Server.

1. Start the application server.


2. Navigate to the following directory in the MDM Hub distribution:

3. Run the following command from the command prompt:


./hub_cleanse_install.bin -i console
4. Enter the number of the locale you want to choose for the installation, and then press Enter.
The introduction information about the installation appears.
5. Press Enter.
The license agreement appears.
6. Read the License Agreement. Type Y to accept the license agreement, or type N if you do not want to
accept the license agreement and want to exit the installation program.
7. Press Enter.
If you entered Y in the preceding step, information about the installation folder appears.
8. Choose the folder for the Process Server installation.
• To choose the default location, press Enter.
• To change the path, type the absolute path of the installation folder, and press Enter.
9. Confirm the location of the installation folder. Type Y to confirm the installation folder, or type N to
change the installation folder.
10. Press Enter.
The prompt for the license file location appears.
11. Enter the absolute path of the license file, and press Enter.
A list of application server options appears.
12. Type the number for the application server that you want to select, and press Enter.
The application server information appears.

Installing the Process Server in Console Mode 71


13. Configure the WebLogic settings.
a. Specify the path to the WebLogic domain in which you want to install the Hub Server, and press
Enter.
The prompts for the WebLogic application server login information appears.
b. Enter the host name, server name, user name, password, and listener port for the WebLogic Server,
or accept the default values, and press Enter.
14. Press Enter.
15. Configure the cleanse engine settings.
• If you use Address Doctor, configure the following parameters:
- Specify the configuration file location, and press Enter.

- Specify the parameters file location, and press Enter.

- Specify the default correction type, and press Enter.


• If you use Business Objects DQ XI, configure the following parameters:
- Specify the host name, and press Enter.

- Specify the port, and press Enter.

- Specify the sub file, and press Enter.

The deployment information appears.


16. Choose whether you want to run the postInstallSetup script as part of the installation, or run it
manually later.
17. Press Enter.
The summary of the installation choices appears.
18. Verify the information in the pre-installation summary. If the information is correct, press Enter to start
the installation. If you need to make changes, type BACK to the specific information and make changes.
The Hub Server is installed according to the configuration information you provide. When the process is
complete, the installation complete information appears.
19. Press Enter.
The Process Server is installed according to the information you specify, and the install complete
information appears.
20. Press Enter to exit the installer.

Installing the Process Server in Silent Mode


You can install the Process Server without user interaction in silent mode. You might want to perform a silent
installation if you need multiple installations, or if you need to install on a machine cluster. A silent installation
does not show any progress or failure messages.

Before you run the silent installation for the Process Server, you must configure the properties file for the
silent installation. The installer reads the file to determine the installation options. The silent installation
process might complete successfully even if you provide incorrect settings, such as an incorrect application
server path or port setting. You must ensure that you provide correct settings in the properties file.

72 Chapter 6: Process Server Installation


Copy the Process Server installation files to the hard disk on the machine where you plan to install the
Process Server. 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 the installer requires. You can
customize the sample properties file to specify the options for the installation. Then run the silent installation.

The silent installer does not validate the settings in the properties files. You must ensure that you specify
correct settings and verify them before you run the silent installer.

1. Locate the sample silentInstallCleanse_sample.properties file in the distribution directory.


The file is in the distribution directory in the following directory:
On UNIX. /silent_install/mrmcleanse
On Windows. \silent_install\mrmcleanse
Note: In the silent properties file, slash and backslash are special characters. You must enter two of
each when you enter information in the file, such as when you enter an installation path. For example, to
enter the path to the Process Server directory, you must enter \\u1\\infamdm\\hub\\cleanse.
2. Create a backup copy of silentInstallCleanse_sample.properties.
3. Use a text editor to open the file and change the values of the installation parameters.
4. Save the properties file with a name such as silentInstallCleanse.properties.
The following table describes the installation parameters that you can modify:

Property Name Description

INSTALLER_UI Specifies the type of installation. Set to silent.

USER_INSTALL_DIR Directory to install Process Server.


For example, C\:\
\<infamdm_install_directory>\\hub\
\cleanse.

SIP.LICENSE.PATH Path to the Informatica license file.

SIP.LICENSE.FILENAME License file name. Set to siperian.license.

SIP.AS.CHOICE Name of the application server. Specify WebLogic.

SIP.AS.HOME The path to the WebLogic installation directory.

SIP.APPSERVER.HOST Host name such as localhost.

SIP.APPSERVER.SERVER Admin Server name such as AdminServer.

SIP.APPSERVER.USERNAME User name to access WebLogic.

SIP.APPSERVER.PASSWORD Password to access WebLogic.

WEBLOGIC.AS.PORT Application server port number.

Installing the Process Server in Silent Mode 73


Property Name Description

SIP.ADDRESSDOCTOR.SETCONFIGFILE Location of the Address Doctor configuration file if your


cleanse engine is Address Doctor.

SIP.ADDRESSDOCTOR.PARAMETERSFILE Location of the Address Doctor parameter file.

SIP.ADDRESSDOCTOR.DEFAULTCORRECTIONTYP Address Doctor Cleanse Engine correction type.


E Specify PARAMETERS_DEFAULT.

RUN_DEPLOYMENT_FLAG Runs the postInstallSetup script as part of the silent


installation. Set to 1 if you want to run postInstallSetup.
Set to 0 if you do not want to run postInstallSetup at
the end of the silent installation.

USER_REQUESTED_RESTART Set the property only for the Windows operating


system. Specifies whether the operating system needs
a restart or not. Default is No.

SIP.FLDIRECT.HOST Host name of FirstLogic.

SIP.FLDIRECT.PORT FirstLogic direct port.

SIP.FLDIRECT.SUBFILE FirstLogic Direct subfile

Sample Properties File


The following example shows the contents of the sample silentInstallCleanse_sample.properties file:
## command to run silent install...
## For Windows: hub_cleanse_install.exe -f <property_file>
## For Unix: hub_cleanse_install.bin -f <property_file>

INSTALLER_UI=silent

## Hub Server Install directory.


USER_INSTALL_DIR=C\:\\siperian\\hub\\cleanse

## License path and filename


SIP.LICENSE.PATH=C\:\\
SIP.LICENSE.FILENAME=siperian.license

## Properties for WebLogic application server


SIP.AS.CHOICE="WebLogic"
SIP.AS.HOME=C\:\\bea\\user_projects\\domains\\base_domain
SIP.APPSERVER.HOST=localhost
SIP.APPSERVER.SERVER=AdminServer
SIP.APPSERVER.USERNAME=weblogic
SIP.APPSERVER.PASSWORD=weblogic
WEBLOGIC.AS.PORT=7001
## Following AddressDoctor properties should be set if you have license for
AddressDoctor.
SIP.ADDRESSDOCTOR.SETCONFIGFILE=C\:\\siperian\\hub\\cleanse\\resources\\AddressDoctor\
\5\\SetConfig.xml
SIP.ADDRESSDOCTOR.PARAMETERSFILE=C\:\\siperian\\hub\\cleanse\\resources\\AddressDoctor\
\5\\Parameters.xml
SIP.ADDRESSDOCTOR.DEFAULTCORRECTIONTYPE=PARAMETERS_DEFAULT

## Following FirstLogicDirect properties should be set if you have lincense for


FirstLogicDirect.
SIP.FLDIRECT.HOST=localhost
SIP.FLDIRECT.PORT=20004

74 Chapter 6: Process Server Installation


SIP.FLDIRECT.SUBFILE=dqxiserver1_substitutions.xml

## If you want to run postInstallSetup as a part of silent install, then set following
property.
## set RUN_DEPLOYMENT_FLAG to 1 if you want to run postInstallSetup
## or set RUN_DEPLOYMENT_FLAG to 0 if you do not want to run postInstallSetup
RUN_DEPLOYMENT_FLAG=1

## If you want to restart the operating system as a part of silent install, set
following properties to 'YES'.
RESTART_NEEDED=NO
USER_REQUESTED_RESTART=NO

Running the Silent Installer


After you configure the properties file, you can start the silent installation.

1. Ensure that the application server is running.


2. Open a command window.
3. Run the following command:
On UNIX. ./hub_cleanse_install.bin -f
<location_of_silent_properties_file_for_cleanse_match_server>
On Windows. hub_cleanse_install.exe -f
<location_of_silent_properties_file_for_cleanse_match_server>
The silent installer runs in the background. The process can take a while. If you ran the post install script
for the Process Server as part of the silent installation, check the postinstallSetup.log files to verify that
the installation was successful.
The log file is available in the following directory:
On UNIX. <infamdm_install_directory>/hub/cleanse/logs/
On Windows. <infamdm_install_directory>\hub\cleanse\logs\

Installing and Deploying the Process Server on


Nodes in the Cluster
If you have a clustered environment, install the Process Server on the Admin Server and on all nodes of the
cluster to which you must deploy the Process Server application. You must ensure that the path for the
Process Server installation is the same on all the cluster nodes.

1. Start the Process Server installer on all nodes of the cluster.


Run the following command to start the Process Server installer:
On UNIX. ./hub_cleanse_install.bin -DSIPERIAN_INSTALL_PREREQ_VALIDATION=false
On Windows. hub_cleanse_install.exe -DSIPERIAN_INSTALL_PREREQ_VALIDATION=false
2. Click No when the installer prompts you to run the postInstallSetup script to deploy the application.
3. When the installer prompts for the WebLogic listener port, enter the managed server ports for any node
in the cluster if the cluster is set up with the development cluster IP address.
Use the DNS name and the cluster port if you use the production cluster IP address.
4. Run the following command to repackage the Process Server EAR file:

Installing and Deploying the Process Server on Nodes in the Cluster 75


On UNIX.
cd <infamdm_install_directory>/hub/cleanse/bin
./sip_ant.sh repackage
On Windows.
cd <infamdm_install_directory>\hub\cleanse\bin
sip_ant.bat repackage
5. Manually deploy the Process Server EAR through the WebLogic Server console.
Note: Select the cluster server name to which you must deploy the application.

76 Chapter 6: Process Server Installation


CHAPTER 7

Process Server Post-Installation


Tasks
This chapter includes the following topics:

• Copy the Installation Log Files, 77


• Verify the Version and Build Number, 80
• Configure the Process Server, 80
• Configure Process Server for Multithreading, 82
• Configuring Multiple Process Servers for Cleanse and Match Operations, 84
• Configuring Multiple Process Servers for Batch Processes, 85
• Configure Match Population, 86

Copy the Installation Log Files


The installation log files are useful for troubleshooting the Process Server installation process. Copy the log
files to the installation documentation directory. Informatica Global Customer Support might request copies of
the log files if you contact them regarding installation issues.

Installation Log File


The installation log file contains information about the installed files.

The following table describes the properties of the installation log file:

Property Description

File Name Informatica_MDM_Cleanse_Match_Server_I


nstall_<timestamp>.xml

Location On UNIX.
<infamdm_install_directory>/hub/
cleanse/UninstallerData/Logs
On Windows. <infamdm_install_directory>
\hub\cleanse\UninstallerData\Logs

77
Property Description

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.

Post-Installation Setup Log File


The post-installation log file contains information about the post-installation process.

The following table describes the properties of the post-installation setup log file:

Property Description

File Name postInstallSetup.log

Location On UNIX.
<infamdm_install_directory>/hub/
cleanse/logs
On Windows. <infamdm_install_directory>
\hub\cleanse\logs

Usage Get information about the post-installation actions that


the installer performs and get information about the
errors in the post-installation process.

Contents Summary of actions performed by the installer during


the post-installation process.

Process Server Log File


The Process Server log file contains information about the Process Server operations.

The following table describes the properties of the Process Server log file:

Property Description

File Name cmxserver.log

Location On UNIX.
<infamdm_install_directory>/hub/
cleanse/logs
On Windows. <infamdm_install_directory>
\hub\cleanse\logs

Usage Get information about the Process Server operations.

Contents Summary of the Process Server operations.

78 Chapter 7: Process Server Post-Installation Tasks


Debug Log File
The installer writes actions and errors to the debug log file.

The following table describes the properties of the debug log file:

Property Description

File Name infamdm_installer_debug.txt

Location On UNIX.
<infamdm_install_directory>/hub/
cleanse/
On Windows. <infamdm_install_directory>
\hub\cleanse\

Usage Get information about the choices that are made during
installation.

Contents Detailed summary of actions performed by the installer.

Installation Prerequisites Log File


The installation prerequisites log file contains information about the prerequisite checks that the installer
performs.

The following table describes the properties of the installation prerequisites log file:

Property Description

File Name installPrereq.log

Location On UNIX.
<infamdm_install_directory>/hub/
cleanse/Logs
On Windows. <infamdm_install_directory>
\hub\cleanse\Logs

Usage Get information about the prerequisite checks


performed by the installer.

Contents Logs of prerequisite validation checks.

WebLogic Server Log Files


The WebLogic Server log file contains information about WebLogic processes.

Copy the Installation Log Files 79


The following table describes the properties of the WebLogic Server log files:

Property Description

File Name access.log


<weblogic_server>.log
<weblogic_domain>.log

Location On UNIX. <Weblogic_domain>/servers/


<Weblogic_server>/logs
On Windows. <Weblogic_domain>\servers
\<Weblogic_server>\logs

Usage Get information about server processes such as


messages and transactions.

Contents Contains message processing status, JMS connection


status, transaction details, java exceptions, and file
access details.

Verify the Version and Build Number


You must ensure that the correct version and build number of the Process Server is installed.

Perform one of the following steps to verify the Process Server version and build number:

• Verify the version and build number in the manifest.mf JAR entry in the siperian-mrm-cleanse.ear file.
The siperian-mrm-cleanse.ear file is in the following directory:
On UNIX. <infamdm_install_directory>/hub/cleanse
On Windows. <infamdm_install_directory>\hub\cleanse
• Verify the version and build number in the versionInfo.xml file that is in the following directory:
On UNIX. <infamdm_install_directory>/hub/cleanse/conf
On Windows. <infamdm_install_directory>\hub\cleanse\conf
• On UNIX. Run versionInfo.sh that is in the following directory:
<infamdm_install_directory>/hub/cleanse/bin
On Windows. Run versionInfo.bat that is in the following directory:
<infamdm_install_directory>\hub\cleanse\bin

Configure the Process Server


After you install the Process Server, you need to configure it. You can configure logging settings, and change
application server, and Process Server settings.

80 Chapter 7: Process Server Post-Installation Tasks


Deploying the Process Server EAR File
Deploy the Process Server EAR file on the same machine where you install the Process Server.

Deploy the Process Server application on the same machine on which you install the Process Server. For
example, if you install the Process Server on a test machine, then deploy the EAR file on the test machine. If
you deploy the EAR on the production machine, the application on production machine cannot locate the
installation for configuration information such as logging.

Configuring the Process Server with Cleanse Engines


After you install the Process Server you can configure a cleanse engine with the Process Server.

For more information about cleanse engine configuration, see the Informatica MDM Multidomain Edition
Cleanse Adapter Guide.

Configuring the Process Server to Delete Temporary Files


You can configure the Process Server to delete the temporary files that the cleanse process generates.

1. Open the cmxcleanse.properties file.


The cmxcleanse.properties file is located in the following directory:
On UNIX.
<infamdm_install_directory>/hub/cleanse/resources/
On Windows.
<infamdm_install_directory>\hub\cleanse\resources\
2. Set the cmx.server.datalayer.cleanse.working_files property to FALSE.
Default is KEEP.

Configuring the Logging Settings


You can configure the Process Server for logging. Specify the configuration settings for logging in the
log4j.xml file.

1. Open log4j.xml in the following directory:


On UNIX. <infamdm_install_directory>/hub/cleanse/conf
On Windows. <infamdm_install_directory>\hub\cleanse\conf
2. Set the value for the following category names:
• com.siperian
• com.delos
• com.informatica
Set the value of category names to DEBUG for the most detailed logging, INFO for less detailed logging,
and ERROR for the least detailed logging. The default is INFO.
3. Set the value for the Threshold parameters to DEBUG.
4. Save and close the file.

Configure the Process Server 81


Setting the Configuration Properties
You can configure the Process Server properties in the cmxcleanse.properties file.

1. Open cmxcleanse.properties in the following directory:


On UNIX. <infamdm_install_directory>/hub/cleanse/resources
On Windows. <infamdm_install_directory>\hub\cleanse\resources
2. Configure the Process Server properties.
A sample configuration of the cmxcleanse.properties is as follows:
cmx.server.datalayer.cleanse.working_files.location=C:\infamdm\hub\cleanse\tmp
cmx.server.datalayer.cleanse.working_files=KEEP
cmx.server.datalayer.cleanse.execution=LOCAL
cmx.home=C:\infamdm\hub\cleanse
cmx.appserver.type=weblogic
3. Save and close the cmxcleanse.properties file.
4. Restart the Process Server application to reload the settings in the file.

Running the PostInstallSetup Script Manually


If you skipped the post install script during installation, you must run the post install script manually.

1. Open a command prompt.


2. Navigate to the PostInstallSetup script in the following directory:
On UNIX. <infamdm installation directory>/hub/cleanse
On Windows. <infamdm installation directory>\hub\cleanse
3. Run the following command:
On UNIX. ./postInstallSetup.sh -Dweblogic.password=<weblogic Password> -
Ddatabase.password=<Database Password>
On Windows. postInstallSetup.bat -Dweblogic.password=<weblogic Password> -
Ddatabase.password=<Database Password>

Manually Redeploying the Process Server EAR File


You can manually redeploy the Process Server on the WebLogic application server.

1. Use the WebLogic Server Administration Console to undeploy the siperian-mrm-cleanse.ear file.
2. Use the WebLogic Server Administration Console to deploy the siperian-mrm-cleanse.ear file.
Ensure that you deploy the Process Server EAR file from the Process Server installation directory.

Configure Process Server for Multithreading


By default, cleanse operations runs in single-threaded mode and batch jobs run in multi-threaded mode. If
the server on which you install the Process Server has more than one CPU, then you can configure the
cleanse operations to be multithreaded to increase performance. The batch operations are multi-threaded by
default, but you can configure the number of threads to use.

82 Chapter 7: Process Server Post-Installation Tasks


You can use the Hub Console to configure the Process Server for multithreading. You need to set the threads
to use for cleanse operations and batch processes. Consider the following factors when you set the thread
count property:

Number of processor cores available on the machine


Set the number of threads to the number of processor cores available on the machine for cleanse
operations. For example, set the number of threads for a dual-core machine to two threads, and set the
number of threads for a single quad-core to four threads.

Set the number of threads to four times the number of processor cores available on the machine for
batch operations. For example, set the number of threads for a dual-core machine to eight threads, and
set the number of threads for a single quad-core to 16 threads.

Remote database connection


If you use a remote database, set the threads for cleanse operations to a number that is slightly higher
than the number of processor cores, so that the wait of one thread is used by another thread. Setting the
number of threads slightly higher accounts for latency that might occur with a remote database.

Process memory requirements

If you run a memory-intensive process, restrict the total memory allocated to all cleanse operation
threads that run under the JVM to 1 GB.

Note: After migration to a later MDM Hub version, you must change the thread count or default values
are used.

Configuring the Process Server for Multithreading


Use the Hub Console to configure the Process Server for multithreading.

1. Expand the Utilities workbench in the Hub Console, and then click Process Server.
The Process Server tool displays the configured Process Servers.
2. Click Write Lock > Acquire Lock.
3. Select the Process Server for which you must configure multithreading.
4. Click Edit Process Server.
The Process Server tool displays the Add/Edit Process Server dialog box.
5. Set the Threads for Cleanse Operations property.
The default value is 1. You can change the threads for cleanse operations without restarting the Process
Server.
6. Set the Threads for Batch Processing.
The default value is 20.
7. Click OK and then click Save.

Configure Process Server for Multithreading 83


Configuring Multiple Process Servers for Cleanse
and Match Operations
You can configure multiple Process Servers for each Operational Reference Store database. You can
configure multiple Process Servers to run on a single machine or on multiple machines.

Ensure that you configure each Process Server to run on a separate application server.

1. Install and configure an instance of the Process Server.


2. Configure multiple application servers.
3. Install and configure the Process Server on each application server.
4. Set the distributed cleanse and match properties in the cmxcleanse.properties file.
The following table describes the distributed cleanse and match properties:

Property Description

cmx.server.match.distributed_match Specifies whether a Process Server is enabled for


distributed cleanse and match. Set to 1 to enable
distributed cleanse and match.

cmx.server.cleanse.min_size_for_distribution Specifies the minimum size for distribution. The


MDM Hub distributes the cleanse job if the minimum
size for distribution is reached. The default is 1,000.

The cmxcleanse.properties is in the following directory:


On UNIX. <infamdm_install_directory>/hub/cleanse/resources
On Windows. <infamdm_install_directory>\hub\cleanse\resources

5. Deploy the Process Server on each application server.


6. Use the Hub Console to connect to the database.
7. Choose the Process Server tool in the Utilities workbench.
8. Click the Add Process Server button to add the Process Server.
9. Configure properties for each Process Server to enable a distributed cleanse process.
The following table describes the properties to set:

Property Description

Offline The MDM Hub ignores the settings for the Offline
property. Taking the Process Server online or offline
is an administrative task.

Enable Cleanse Operations Specifies whether to use the Process Server for
cleanse operations. Enable to use Process Server
for cleanse operations. Disable if you do not want to
use the Process Server for cleansing. Default is
enabled.

84 Chapter 7: Process Server Post-Installation Tasks


Property Description

Threads for Cleanse Operations Specifies the number of threads that a server must
handle. Set the thread count higher than the number
of CPUs available.

Enable Match Processing Specifies whether to use the Process Server for
match operations. Enable to use Process Server for
match operations. Disable if you do not want to use
the Process Server for match operations. Default is
enabled.

CPU Rating Rates the relative strength of CPUs of the Process


Server machines. Assign a higher rating to a
machine with a more powerful CPU. The MDM Hub
assigns jobs to machines based on CPU rating.

10. Click OK and then Save.

Configuring Multiple Process Servers for Batch


Processes
You can configure multiple Process Servers for each Operational Reference Store database. You can
configure multiple Process Servers to run on a single machine or on multiple machines.

Ensure that you configure each Process Server to run on a separate application server.

1. Install and configure an instance of the Process Server.


2. Configure multiple application servers.
3. Install and configure the Process Server on each application server.
4. Deploy the Process Server on each application server.
5. Use the Hub Console to connect to the database.
6. Choose the Process Server tool in the Utilities workbench.
7. Click the Add Process Server button to add a Process Server.
8. Configure properties for each Process Server to enable for batch processing.

Configuring Multiple Process Servers for Batch Processes 85


The following table describes the properties to set:

Property Description

Offline Specifies whether a Process Server is online or


offline. Disable this property to ensure that a
Process Server is online.

Enable Batch Processing Specifies whether to use the Process Server for
batch processing. Enable to use Process Server for
batch jobs. Disable if you do not want to use the
Process Server for batch jobs. Default is enabled.

Threads for Batch Processing Specifies the number of threads that a server must
handle for batch processing. Set the threads to four
times the number of processor cores available on
the machine.

9. Click OK and then Save.

Configure Match Population


The match population contains the standard population set to use for the match process. Each supported
country, language, or population has a standard population set. You must enable the match population to use
for the match rules.

The match population is available as a population.ysp file with the Informatica MDM Hub installation. The
population name is the same as the ysp file name. If you add a Japanese population, and want to use the
Person_Name_Kanji match field, add _Kanji to the population name. For example, Japan_Kanji or
Japan_i_Kanji. If you do this, the standard Person_Name match field is not available.

The population that you use must be compatible with the SSA-Name3 version of the MDM Hub. If you need
additional population files or if you need an updated population file to upgrade to a later version, log a service
request at the Informatica MySupport Portal at http://mysupport.informatica.com. The first population file that
you request with the product is free. You might need population files for other countries or you might need an
updated population file to upgrade to a later version of the MDM Hub.

Enabling Match Population


You must enable the match population to use for the match rules.

1. Copy the <population>.ysp files to the following location:


On UNIX. <infamdm_install_directory>/hub/cleanse/resources/match
On Windows. <infamdm_install_directory>\hub\cleanse\resources\match
2. In the C_REPOS_SSA_POPULATION metadata table, verify that the population is registered.
The seed database for the MDM Hub installation has some populations registered in the
C_REPOS_SSA_POPULATION table, but not enabled.

86 Chapter 7: Process Server Post-Installation Tasks


3. If the C_REPOS_SSA_POPULATION table does not contain the population, add it to the table and
enable it.
The population name is the same as the ysp file name. For example, if the ysp file name is US.ysp, the
population name is US.
To add the population to an Operational Reference Store, use the following steps:
a. Run the add_std_ssa_population.bat script in the following directory:
<infamdm_install_directory>\server\resources\database\custom_scripts\MSSQL
b. Answer the prompts described in the following table:

Prompt Description

Host name with Microsoft SQL Server instance Host name of the Microsoft SQL Server instance.
for CMX_ORS database ("localhost")

cmx_ors user name ("cmx_ors") User name of the Operational Reference Store.

cmx_ors user password Password of the Operational Reference Store.

Enter the population name (Note: If you use Name of the population.
Person_Name_Kanji for the Japan population or
Japan_i population, add the suffix '_Kanji' to the
end of the name) DEFAULT (" ")

Enter a value for ROWID_SSA_POP (example: Unique value for the ROWID_SSA_POP column
INFA.0001) DEFAULT (INFA.0001) of the C_REPOS_SSA_POPULATION metadata
table.

The population is registered in the C_REPOS_SSA_POPULATION table.

c. Run the following command to enable the population:


USE <Operational Reference Store user>
GO
UPDATE [dbo].[C_REPOS_SSA_POPULATION] SET ENABLED_IND = 1 WHERE POPULATION_NAME
= '<Your Population>'

4. Restart the Process Server after you enable populations.


5. Log in to the Hub Console to verify that the population is enabled.
The population appears in the Match/Merge Setup user interface for base objects.

Configure Match Population 87


CHAPTER 8

Resource Kit Installation


This chapter includes the following topics:

• Setting Up the MDM Hub Sample Operational Reference Store, 88


• Registering the Informatica MDM Hub Sample Operational Reference Store, 90
• Installing the Resource Kit in Graphical Mode, 91
• Installing the Resource Kit in Console Mode, 94
• Installing the Resource Kit in Silent Mode, 96
• Installing and Deploying the Resource Kit into a WebLogic Cluster, 100

Setting Up the MDM Hub Sample Operational


Reference Store
Before you can use the MDM Hub sample Operational Reference Store, you must set it up. Before you install
the Resource Kit, set up the MDM Hub sample Operational Reference Store. To set up the MDM Hub sample
Operational Reference Store, create an Operational Reference Store and import mdm_sample into it.

1. Navigate to the following location in the distribution directory:


On UNIX. <distribution directory>/database/bin
On Windows. <distribution directory>\database\bin
2. Run the following command:
On UNIX. sip_ant.sh create_ors
On Windows. sip_ant.bat create_ors
3. Answer the prompts that appear.
Note: The prompt displays default text in brackets. Press Enter to use the default value and go to the
next prompt.
Enter database type. (ORACLE, MSSQL, DB2)
Database type. Specify MSSQL.

Enter the Operational Reference Store database host name. [localhost]


Name of the machine that hosts the database. Default is localhost.

88
Enter the Operational Reference Store database port number. [1433]
Port number that the database uses.Default is 1433.

Connect URL. [jdbc:sqlserver://<host name>:<port>]


Connect URL for the database connection.

Enter the Operational Reference Store database user name. [cmx_ors]


User name of the MDM Hub sample Operational Reference Store database. Default is cmx_ors.

Enter CMX_ORS database path. ['C:\MSSQLDATA"]


Path to the Microsoft SQL Server data file store enclosed in double quotation marks.

Enter CMX_SYSTEM database collation name [Latin1_General_CI_AS]


Collation name to set a collation sequence for the MDM Hub Master Database.

Enter the Operational Reference Store database user password.


Password of the MDM Hub sample Operational Reference Store user.

Enter a locale name from the list: de, en_US, fr, ja, ko, zh_CN. [en_US]
Operating system locale. Default is en_US.

Enter the DBA user name. [sa]


Default is sa.

Enter the DBA password.


Password of the SA user account.
4. After you create the sample Operational Reference Store, review sip_ant.log in the following directory:
On UNIX. <distribution directory>/database/bin
On Windows. <distribution directory>\database\bin
The sip_ant.log file logs any errors that might occur when you run the sip_ant script to create the
Operational Reference Store.
5. To import mdm_sample, run the following command:
On UNIX. sip_ant.sh import_schema
On Windows. sip_ant.bat import_schema

Setting Up the MDM Hub Sample Operational Reference Store 89


6. Answer the prompts that appear.
Note: The prompt displays default text in brackets. Press Enter to use the default value and go to the
next prompt.
Enter database type. (ORACLE, MSSQL, DB2)
Database type. Specify MSSQL.

Enter the Operational Reference Store database host name. [localhost]


Name of the machine that hosts the database. Default is localhost.

Enter the Operational Reference Store database port number. [1433]


Port number that the database uses.Default is 1433.

Connect URL. [jdbc:sqlserver://<host name>:<port>]

Connect URL for the database connection.

Enter the Operational Reference Store database user name. [cmx_ors]


Name of the MDM Hub sample Operational Reference Store database. Default is cmx_ors.

Enter the Operational Reference Store database user password.


Name of the MDM Hub sample Operational Reference Store database user.

Enter a locale name from the list: de, en_US, fr, ja, ko, zh_CN. [en_US]
Operating system locale. Default is en_US.

Enter the path to the ZIP dump file. [<distribution directory>\resources\database]

Path to the mdm_sample.zip file.

Enter the name of the ZIP dump file. [mdm_sample.zip]


Name of the ZIP dump file. Default is mdm_sample.zip.

Registering the Informatica MDM Hub Sample


Operational Reference Store
After you set up the MDM Hub sample Operational Reference Store, you must register it. Register the MDM
Hub sample Operational Reference Store through the Hub Console.

1. Start the Hub Console.


The Change database dialog box appears.
2. Select the MDM Hub Master Database, and click Connect.
3. Start the Databases tool under the Configuration workbench.
4. Click Write Lock > Acquire Lock.
5. Click the Register database button.
The Informatica MDM Hub Connection Wizard appears and prompts you to select the database type.
6. Select the type of database, and click Next.

90 Chapter 8: Resource Kit Installation


7. Configure connection properties for the database.
a. In the Connection Properties page, specify the connection properties, and then click Next.
The following table lists and describes the connection properties:

Property Description

Database Display Name for the Operational Reference Store that must appear in the Hub
Name Console.

Machine Identifier Prefix given to keys to uniquely identify records from the Hub Store instance.

Database hostname IP address or name of the server that hosts the Microsoft SQL Server
database.

Port Port of the Microsoft SQL Server database. The default is 1433.

Schema Name Name of the Operational Reference Store. Specify mdm_sample.

Password Password associated with the user name for the Operational Reference Store.

b. In the Connection Properties page, specify the connection properties, and then click Next.
c. Review the summary, and specify additional connection properties.
The following table lists additional connection properties that you can configure:

Property Description

Connection URL Connect URL. The Connection Wizard generates the connect URL by
default.

Create data source after Select to create the data source on the application server after
registration registration.

8. Click Finish.
The Registering Database dialog box appears.
9. Click OK.
The MDM Hub registers the MDM Hub sample Operational Reference Store.
10. Select the MDM Hub sample Operational Reference Store that you registered, and click the Test
database connection button to test the database settings.
The Test Database dialog box displays the result of the database connection test.
11. Click OK.
The Operational Reference Store is registered, and the connection to the database is tested.

Installing the Resource Kit in Graphical Mode


You can install the Resource Kit in graphical mode.

Installing the Resource Kit in Graphical Mode 91


Before you install the Resource Kit, you must have installed and configured the MDM Hub.

1. Start the application server.


2. Open a command prompt and navigate to the Resource Kit installer. By default the installer is in the
following directory:
On UNIX. <distribution directory>/<operating system name>/mrmresourcekit
On Windows. <distribution directory>\windows\mrmresourcekit
3. Run the following command:
On UNIX. hub_resourcekit_install.bin
On Windows. hub_resourcekit_install.exe
4. Select the language for the installation, and then click OK.
The Introduction window appears.
5. Click Next.
The License Agreement window appears.
6. Select the I accept the terms of the License Agreement option, and then click Next.
The Installation Feature window appears.
7. Select the Resource Kit features that you want to install and click Next.
You can select the following options:
Sample Schema
Installs the MDM Hub sample schema resources. You must create a sample schema and register it
with the Hub Server before you install the sample applications.

Samples and Utilities


Installs the sample applications and utilities.
The list of sample applications that are deployed is stored in the build.properties file in the
following directory:
<Resourcekit_Home>\samples

SIF SDK and Javadocs


Installs the javadocs, libraries, and resources associated with the SIF SDK.

BPM SDK
Installs the resources associated with the BPM SDK.

Jaspersoft
Copies the Jaspersoft installer to the Resource Kit home.

SSA-NAME3
Copies the SSA-NAME3 installer to the Resource Kit home.

A message about the requirement of having created and registered a sample schema with the MDM Hub
appears.
8. Click OK.
The Choose Install Folder window appears.
9. Select the location of the Resource Kit installation.
• To choose the default location, click Next.
• To enter a path, type the path to the installation folder, and click Next.

92 Chapter 8: Resource Kit Installation


Note: The installation fails if you specify a path that has spaces in the directory or folder names.
• To return to the default installation location, click Restore Default Folder.
• To choose another location, click Choose, and then click Next.
On UNIX, the Choose Link Folder window appears.
On Windows, the Choose Shortcut Folder window appears.
10. On UNIX, choose a link folder or select the option to not create links, and click Next. On Windows, select
the location to create a product icon or select the option not to create a product icon.
The Configuration Selection window appears.
11. Select a configuration option, and click Next.
You can select one of the following options:
Configure Samples
Installs and configures the samples.

Source Only
Installs the sources of samples but does not configure the samples.

If you select Configure samples, the Resource Kit App Server window appears. If you select Source
only, the Pre-Installation Summary window appears.
12. From the Resource Kit App Server window, select the application server on which you want to install
the Resource Kit, and click Next.
The Application Server Home window for the application server that you select appears.
13. Configure the application server settings.
a. Choose a path to the WebLogic domain installation directory for the domain that you want to use for
the MDM Hub, and click Next.
The WebLogic Application Server Login window appears.
b. Enter the WebLogic Server login information.
Enter values in the following login parameter fields:
Host
Name of the host computer that has the WebLogic installation.

Server
Name of the WebLogic Server instance in the domain on which WebLogic is deployed.

User Name
Name of the user for the WebLogic installation.

Password
Password that corresponds to the WebLogic user.

Port Number
Port number on which the WebLogic Server is listening.
The Informatica MDM Hub Server window appears.
14. Enter the information for the Hub Server installation, and click Next.
Enter values in the following fields:
Server Name
Name of the server that hosts the Hub Server.

Installing the Resource Kit in Graphical Mode 93


Server HTTP Port
Port number of the Hub Server.

Informatica MDM Administrative password


Password to access the MDM Hub.

The Resource Kit ORS ID window appears.


15. Select a Resource Kit ORS ID from the list, and then click Next.
The list contains the Operational Reference Store IDs that you created. Select an Operational Reference
Store ID related to the sample schema.
If you have not registered the sample schema, you will not see the Operational Reference Store ID for
the sample schema. Register the sample Operational Reference Store, and then restart the installation.
The Deployment Selection window appears.
16. Select one of the following options and click Next:
Yes, run it during this installation.
Deploys and configures the Resource Kit during the installation.

No, it can be deployed later.


Select this option to deploy and configure manually at a later time.
If you chose to install the Samples and Utilities feature, you must deploy and configure the
Resource Kit in this installation step. If you do not install the Resource Kit in this step, you cannot
make changes and redeploy the samples by using the postInstallSetup script provided in the
Resource Kit.
If you choose to run the post-installation setup manually, you cannot deploy the EAR file by using
the postInstallSetup script at a later time. You must manually edit the EAR file and deploy it to make
any changes to your installation.

The Pre-Installation Summary window appears.


17. Review the Pre-Installation Summary to confirm your installation choices, and then click Install.
When the installation completes, the Install Complete window appears.
18. Click Done to exit the Resource Kit installer.

Installing the Resource Kit in Console Mode


You can install the Resource Kit in console mode.

Ensure that you register the MDM_SAMPLE schema before you install the Resource Kit.

1. Start the application server.


2. Navigate to the following directory in the MDM Hub distribution:
On UNIX. <distribution directory>/<operating system name>/resourcekit
On Windows. <distribution directory>/windows/resourcekit
3. Run the following command from the command prompt:
On UNIX. ./hub_install.bin -i console
On Windows. hub_resourcekit_install.exe -i console

94 Chapter 8: Resource Kit Installation


4. Enter the number of the locale you want to choose for the installation, and then press Enter.
The introduction information about the installation appears.
5. Press Enter.
The license agreement appears.
6. Read the License Agreement. Type Y to accept the terms of the license agreement, or type N if you do
not want to accept the license agreement and want to exit the installation program.
7. Press Enter.
If you entered Y in the preceding step, information about the installation folder appears.
8. Enter the numbers of the Resource Kit features that you want to install separated by commas, and press
Enter.
The prompt for the sample schema installation appears.
9. Choose a folder for the Resource Kit installation.
• To choose the default folder, press Enter.
• To change the path, type the absolute path of the installation folder, and press Enter.
10. Confirm the location of the installation folder. Type OK to confirm the installation folder or type Cancel to
change the installation folder.
11. Press Enter.
A list of link location options appears.
12. Enter the number of a link location option.
The prompt for the link file location appears.
13. Enter the absolute path of the link file, and press Enter.
The source sample configuration options appears.
14. Enter a configuration option, and press Enter.

Option Description

1 Installs and configures the samples

2 Installs the sources of samples but does not configure the samples

If you enter 1, a list of application server options appears. If you enter 2, the pre-Installation summary
appears.
15. If you entered 1, enter the number for the application server that you want to select, and press Enter.
The application server information prompts appear.
16. Configure the WebLogic settings.
a. Specify the path to the WebLogic domain in which you want to install the Resource Kit, and press
Enter.
The prompts for the WebLogic application server login information appears.
b. Enter the host name, server name, user name, password, and listener port for the WebLogic Server,
or accept the default values, and press Enter.
The Hub Server installation information prompts appear.
17. Enter the information for the Hub Server installation, and press Enter.

Installing the Resource Kit in Console Mode 95


The following table describes the prompts for the Hub Server installation information:

Prompt Description

Server Name Name of the server that hosts the Hub Server.

Server HTTP Port Port number of the Hub Server.

Informatica MDM Administrative password Password to access the MDM Hub.

A list of MDM Hub ORS IDs appears.

18. Enter the Operational Reference Store ID of the MDM sample schema, and press Enter.
If you did not register the sample schema, you will not see the Operational Reference Store ID for the
sample schema. Register the sample Operational Reference Store, and then restart the installation.
The deployment selection prompt appears.
19. Choose whether you want to run the postInstallSetup script as part of the installation, or run it
manually later.
20. Press Enter.
The summary of the installation choices appears.
21. Verify the information in the pre-installation summary. If the information is correct, press Enter to start
the installation.
The Resource Kit is installed according to the configuration information you provide. When the process is
complete, the installation complete information appears.
22. Press Enter to exit the installer.

Installing the Resource Kit in Silent Mode


You can install the Resource Kit without user interaction in silent mode. You might want to perform a silent
installation if you need multiple installations, or if you need to install on a machine cluster. A silent installation
does not show any progress or failure messages.

Before you run the silent installation for the Resource Kit, you must configure the properties file for the silent
installation. The installer reads the file to determine the installation options. The silent installation process
might complete successfully even if you provide incorrect settings, such as an incorrect application server
path or port. You must ensure that you provide correct settings in the properties file.

Copy the Resource Kit installation files to the hard disk on the machine where you plan to install the
Resource Kit. 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 the installer requires. You can
customize the sample properties file to specify the options for the installation. Then run the silent installation.

96 Chapter 8: Resource Kit Installation


The silent installer does not validate the settings in the properties files. You must ensure that you specify
correct settings and verify them before you run the silent installer.

1. Find the silentInstallResourceKit_sample.properties file in the following directory:


On UNIX. /silent_install/mrmresourcekit
On Windows. \silent_install\mrmresourcekit
After you customize the file, save it. You can rename the file and put it anywhere on the machine.
Note: In the silent properties file, slash and backslash are special characters. You must enter two of
each of these characters when you enter information in the file, such as when you enter an installation
path. For example, to enter the path to the server directory, you must enter \\u1\\infamdm\\hub\
\resourcekit.
2. Create a backup copy of the silentInstallResourceKit_sample.properties file.
3. Use a text editor to open the file and change the values of the installation parameters.
4. Save the properties file with a new name such as silentInstallresourcekit.properties.
The following table describes the installation parameters that you can change:

Property Name Description

INSTALLER_UI Specifies the mode of installation. Set to silent.

SIP.INSTALL.TYPE Specifies the type of installation. Set to


SIPERIAN_SAMPLE_INSTALL.

SIP.INSTALL.SAMPLE.SCHEMA Specifies if you want to install the sample schema.


Specify one of the following values:
- 0. Does not install the sample schema
- 1. Installs the sample schema

SIP.INSTALL.SAMPLES Specifies if you want to install samples and utilities.


Specify one of the following values:
- 0. Does not install samples and utilities
- 1. Installs samples and utilities

SIP.INSTALL.SIF.SDK Specifies if you want to install the Services Integration


Framework (SIF) SDK.
Specify one of the following values:
- 0. Does not install the SIF SDK
- 1. Installs SIF SDK

SIP.INSTALL.BPM.SDK Specifies if you want to install the BPM SDK.


Specify one of the following values:
- 0. Does not install the BPM SDK
- 1. Installs the SIF SDK

SIP.INSTALL.JASPERSOFT Specifies if you want to install the Jaspersoft reporting


tool.
Specify one of the following values:
- 0. Does not install the BPM SDK
- 1. Installs the SIF SDK

Installing the Resource Kit in Silent Mode 97


Property Name Description

SIP.INSTALL.SSANAME3 Specifies if you want to install SSA-NAME3.


Specify one of the following values:
- 0. Does not install SSA-NAME3
- 1. Installs SSA-NAME3

USER_INSTALL_DIR Directory where you want to install the Resource Kit,


such as C\:\\<infamdm_install_directory>\
\hub\\resourcekit.

RUN_CONFIGURE_FLAG Specifies if you want to configure samples.


- 0. Does not configure samples
- 1. Installs and configures samples
Default is 1.
If you set the RUN_CONFIGURE_FLAG property to 1,
comment out or set the RUN_CONFIGURE_SETUP
property to 0. To configure samples, ensure that the
application server and the Hub Server are started and
the sample schema is registered in the Hub Console.

RUN_CONFIGURE_SETUP Specifies if you want to configure only source samples.


- 0. Does not install sources of samples
- 1. Installs sources of samples
If you set the RUN_CONFIGURE_SETUP property to
1, comment out or set the RUN_CONFIGURE_FLAG
property to 0. If you set the
RUN_CONFIGURE_SETUP property to 1, you cannot
configure and deploy samples later.

SIP.AS.CHOICE Name of the application server. Specify WebLogic.

SIP.AS.HOME The path to the WebLogic installation directory.

SIP.APPSERVER.HOST Host name such as localhost.

SIP.APPSERVER.SERVER Admin Server name such as AdminServer.

SIP.APPSERVER.USERNAME User name to access WebLogic.

SIP.APPSERVER.PASSWORD Password to access WebLogic.

WEBLOGIC.AS.PORT Application server port number.

SIP.SERVER.NAME Name of the server on which the Hub Server is


deployed.

SIP.SERVER.HTTP.PORT Port on which the Hub Server is listening.

SIP.ADMIN.PASSWORD Password to access the Hub Server.

98 Chapter 8: Resource Kit Installation


Property Name Description

SIP.ORS.ID Operational Reference Store ID of the MDM Hub


sample schema.

RUN_DEPLOYMENT_FLAG Runs the postInstallSetup script as part of the silent


installation.
- 0. Does not run the postInstallSetup script
- 1. Runs the postInstallSetup script

Sample Properties File


The following example shows the contents of the sample silentInstallResourceKit_sample.properties
file:
INSTALLER_UI=silent
SIP.INSTALL.TYPE=SIPERIAN_SAMPLE_INSTALL

#Installation Features
#0=Do not install
#1=Install

SIP.INSTALL.SAMPLE.SCHEMA=1
SIP.INSTALL.SAMPLES=1
SIP.INSTALL.SIF.SDK=1
SIP.INSTALL.BPM.SDK=1
SIP.INSTALL.JASPERSOFT=1
SIP.INSTALL.SSANAME3=1

## Resource Kit Install directory.


USER_INSTALL_DIR=C\:\\siperian\\hub\\resourcekit

## If you want to configure samples as a part of silent installation, set following


property:
RUN_CONFIGURE_FLAG=1
## If you want to install only source samples as a part of silent installation, set
following property:
#RUN_CONFIGURE_SETUP=0

## Set the properties for one of the application servers JBoss, WebSphere, or WebLogic.

## properties for WebLogic application server


SIP.AS.CHOICE="WebLogic"
SIP.AS.HOME=C\:\\weblogic\\user_projects\\domains\\base_domain
SIP.APPSERVER.HOST=localhost
SIP.APPSERVER.SERVER=AdminServer
SIP.APPSERVER.USERNAME=weblogic
SIP.APPSERVER.PASSWORD=weblogic
WEBLOGIC.AS.PORT=7001

## properties for MDM Hub Server


SIP.SERVER.NAME=localhost
SIP.SERVER.HTTP.PORT=7001
SIP.ADMIN.PASSWORD=admin

#sip ors id from hub server


SIP.ORS.ID=localhost-orcl-MDM_SAMPLE

## If you want to run postInstallSetup as a part of silent installation, set the


following property:
RUN_DEPLOYMENT_FLAG=1
## If you want to run postInstallSetup as a part of silent installation, set the
following property:
RUN_DEPLOYMENT_FLAG=0

Installing the Resource Kit in Silent Mode 99


Running the Silent Installer
After you configure the properties file, you can start the silent installation.

1. Ensure that the application server is running.


2. Open a command window.
3. Run the following command:
On UNIX. ./hub_resourcekit_install.bin -f
<location_of_silent_properties_file_for_resourcekit>
On Windows. .\hub_resourcekit_install.exe -f
<location_of_silent_properties_file_for_resourcekit>
The silent installer runs in the background. The process can take a while. Check the postinstallSetup.log
files to verify that the installation was successful.

The log file is available in the following directory:

On UNIX. <infamdm_install_directory>/logs/postInstall.log

On Windows. <infamdm_install_directory>\logs\postInstall.log

Installing and Deploying the Resource Kit into a


WebLogic Cluster
After you install the Hub Server and register the MDM Hub sample Operational Reference Store, you can
install the Resource Kit.

In a clustered environment, install the Resource Kit on each node of the cluster where you want to deploy the
Resource Kit.

Note: Ensure that the directory structure of the Resource Kit installation is the same on all the cluster nodes.

1. Start the application server.


2. Open a command prompt and navigate to the Resource Kit installer. By default the installer is in the
following directory:
On UNIX. <distribution directory>/<operating system name>/mrmresourcekit
On Windows. <distribution directory>\windows\mrmresourcekit
3. Run the following command:
On UNIX. hub_resourcekit_install.bin
On Windows. hub_resourcekit_install.exe
4. Select the language for the installation, and then click OK.
The Introduction window appears.
5. Click Next.
The License Agreement window appears.
6. Select the I accept the terms of the License Agreement option, and then click Next.
The Installation Feature window appears.
7. Select the Resource Kit features that you want to install and click Next.

100 Chapter 8: Resource Kit Installation


You can select the following options:
Sample Schema
Installs the MDM Hub sample schema resources. You must create a sample schema and register it
with the Hub Server before you install the sample applications.

Samples and Utilities


Installs the sample applications and utilities.
The list of sample applications that are deployed is stored in the build.properties file in the
following directory:
<Resourcekit_Home>\samples

SIF SDK and Javadocs


Installs the javadocs, libraries, and resources associated with the SIF SDK.

BPM SDK
Installs the resources associated with the BPM SDK.

Jaspersoft
Copies the Jaspersoft installer to the Resource Kit home.

SSA-NAME3
Copies the SSA-NAME3 installer to the Resource Kit home.

A message about the requirement of having created and registered a sample schema with the MDM Hub
appears.
8. Select the location of the Resource Kit installation.
• To choose the default location, click Next.
• To enter a path, type the path to the installation folder, and click Next.
Note: The installation fails if you specify a path that has spaces in the directory or folder names.
• To return to the default installation location, click Restore Default Folder.
• To choose another location, click Choose, and then click Next.
On UNIX, the Choose Link Folder window appears.
On Windows, the Choose Shortcut Folder window appears.
9. On UNIX, choose a link folder or select the option to not create links, and click Next. On Windows, select
the location to create a product icon or select the option not to create a product icon.
The Configuration Selection window appears.
10. Select a configuration option, and click Next.
You can select one of the following options:
Configure Samples
Installs and configures the samples.

Source Only
Installs the sources of samples but does not configure the samples.

If you select Configure samples, the Resource Kit App Server window appears. If you select Source
only, the Pre-Installation Summary window appears.
11. From the Resource Kit App Server window, select the application server on which you want to install
the Resource Kit, and click Next.
The Application Server Home window for the application server that you select appears.

Installing and Deploying the Resource Kit into a WebLogic Cluster 101
12. Configure the application server settings.
a. Choose a path to the WebLogic domain installation directory for the domain that you want to use for
the MDM Hub, and click Next.
The WebLogic Application Server Login window appears.
b. Enter the WebLogic Server login information.
Enter values in the following login parameter fields:
Host
Name of the host computer that has the WebLogic installation.

Server
Name of the WebLogic Server instance in the domain on which WebLogic is deployed.

User Name
Name of the user for the WebLogic installation.

Password
Password that corresponds to the WebLogic user.

Port Number
Port number on which the WebLogic Server is listening.
The Informatica MDM Hub Server window appears.
13. Enter the information for the Hub Server installation, and click Next.
Enter values in the following fields:
Server Name
Name of the server that hosts the Hub Server.

Server HTTP Port


Cluster member port number of the Hub Server.

Informatica MDM Administrative password


Password to access the MDM Hub.

The Resource Kit ORS ID window appears.


14. Select a Resource Kit ORS ID from the list, and then click Next.
The list contains the Operational Reference Store IDs that you created. Select an Operational Reference
Store ID related to the sample schema.
If you have not registered the sample schema, you will not see the Operational Reference Store ID for
the sample schema. Register the sample Operational Reference Store, and then restart the installation.
The Deployment Selection window appears.
15. Select one of the No, it can be deployed later option, and click Next.
The Pre-Installation Summary window appears.
16. Review the Pre-Installation Summary to confirm your installation choices, and then click Install.
When the installation completes, the Install Complete window appears.
17. Click Done to exit the Resource Kit installer.
18. After the installation, run the following command to repackage the EAR files:
On UNIX. cd <resourcekit_install_dir>/deploy/bin sip_ant.sh repackage
On Windows. cd <resourcekit_install_dir>/deploy/bin sip_ant.bat repackage

102 Chapter 8: Resource Kit Installation


19. Manually deploy the sample EAR files to the cluster through the WebLogic Server Administrator console.
The EAR files are LookupWebServiceExample.ear and PartyWebServiceExample.ear.
20. Restart the cluster servers and member nodes.

Installing and Deploying the Resource Kit into a WebLogic Cluster 103
CHAPTER 9

Troubleshooting the MDM Hub


This chapter includes the following topic:

• Troubleshooting the Installation Process, 104

Troubleshooting the Installation Process


If the installation fails, use the following information to troubleshoot the failure.

PostInstallSetUp script fails because the ActiveVOS server deployment times out
When you install the Hub Server, the post-installation setup process might fail after trying to deploy the
ActiveVOS server.

To resolve the issue, increase the value of the deploy.wait.time property in the build.properties file in
the following directory:

On UNIX. <infamdm installation directory>/hub/server/bin

On Windows. <infamdm installation directory>\hub\server\bin

Failed to verify the need to tokenize records


When you run the Match process, you might receive the following error:
SIP-16062: Failed to verify the need to tokenize records.

Verify the following environment variable settings:

• The PATH environment variable must contain the following path:


On UNIX. <infamdm_install_directory>/hub/cleanse/lib
On Windows. <infamdm_install_directory>\hub\cleanse\lib
• The SSAPR environment variable must include the following path for all users:
On UNIX. <infamdm_install_directory>/server_install_dir>/cleanse/resources
On Windows. <infamdm_install_directory>\server_install_dir>\cleanse\resources

major.minor version errors when loading the Process Server


If you see multiple major.minor console errors when you try to load the Process Server, check that the
system has the correct Java version installed.

104
Hub Server cache timeout exception
If the Hub server cannot acquire a cache object lock, you must change the jbossCacheConfig.xml file to
increase the lock acquisition and replication timeouts. The jbossCacheConfig.xml file is in the following
location:

On UNIX. <infamdm_install_dir>/server/resources/jbossCacheConfig.xml.

On Windows. <infamdm_install_dir>\server\resources\jbossCacheConfig.xml.

For example, increase lock acquisition timeout and replication timeout as shown in the following sample:
<locking
...
lockAcquisitionTimeout="30000"
...
/>
<sync replTimeout="30000"/>

Address Doctor exception during certification


Address Doctor generates an exception during certification. Ensure that the stack size for the JVM is
sufficient.

1. Navigate to the WebLogic home directory.


2. Open the following file in a text editor.
On UNIX. setDomainEnv.sh
On Windows. startWeblogic.cmd
3. Use the following command to set the MEM_ARGS variable:
On UNIX.
set MEM_ARGS=${MEM_ARGS} -Xss2000k
On Windows.
set MEM_ARGS=%MEM_ARGS% -Xss2000k
4. Save and close the file.

Operational Reference Store does not have a workflow engine configured


If you install the MDM Hub and then import an Operational Reference Store (ORS) from a previous version,
you see a fatal error that indicates that the ORS does not have a workflow engine configured. This error
occurs because the Siperian BPM workflow engine is not registered by default. Use the Workflow Manager to
register the Siperian BPM workflow engine with the name that the ORS expects to find.

Troubleshooting the Installation Process 105


CHAPTER 10

Uninstallation
This chapter includes the following topics:

• Uninstallation Overview, 106


• Uninstalling the Hub Store, 106
• Uninstalling the Process Server in Graphical Mode, 107
• Uninstalling the Hub Server in Graphical Mode, 108
• Uninstalling the Resource Kit in Graphical Mode, 108
• Uninstalling the Process Server in Console Mode, 109
• Uninstalling the Hub Server in Console Mode, 109
• Uninstalling the Resource Kit in Console Mode, 110
• Manually Undeploying the Process Server, 110
• Manually Undeploying the Hub Server, 110

Uninstallation Overview
To uninstall the MDM Hub, you need to remove the Process Server, the Hub Server, and the Hub Store from
the MDM Hub implementation.

Use the following steps to uninstall the MDM Hub:

1. Uninstall the Hub Store.


2. Uninstall the Process Server.
3. Uninstall the Hub Server.

Uninstalling the Hub Store


You can uninstall the Hub Store by dropping the Hub Store schemas and removing the user logins for the
Hub Store schemas. Before you drop the Hub Store schemas, use the Hub Console to unregister the Hub
Store schemas.

You must have administrator privileges to drop the Hub Store schemas.

1. Start the Hub Console.

106
2. Click the Databases tool under the Configuration workbench.
The Database Information page appears.
3. Click Write Lock > Acquire Lock.
4. From the list of databases, select the Operational Reference Store to unregister.
5. Click the Unregister database button.
The Databases tool prompts you to confirm unregistering the Operational Reference Store.
6. Click Yes.
7. Use Microsoft SQL Management Studio to connect to the Microsoft SQL Server instance.
8. Right-click each Hub Store schema, and then click Delete.
The Delete Object window appears.
9. Click OK.
The Hub Store schema is dropped.

Uninstalling the Process Server in Graphical Mode


You can uninstall the Process Server in graphical mode.

Uninstalling the Process Server in Graphical Mode On UNIX


To uninstall the MDM Hub, you must remove the Process Server. You must perform the steps to uninstall the
Process Server for each Process Server in the MDM Hub implementation.

1. Stop the application server.


2. Navigate to the following directory:
<infamdm_install_directory>/hub/cleanse/UninstallerData
3. Run the uninstaller.
./"Uninstall Informatica MDM Hub Cleanse Match Server"
4. Click Uninstall.
When the uninstallation process is complete, the Uninstall Complete window appears.
5. Click Done.

Uninstalling the Process Server in Graphical Mode On Windows


To uninstall the MDM Hub, you must remove the Process Server. You must perform the steps to uninstall the
Process Server for each Process Server in the MDM Hub implementation.

1. Stop the application server.


2. Click Start and then click Programs > Infamdm > Hub > Cleanse > Uninstaller Data > Uninstall
Informatica MDM Hub Cleanse Match Server.
The Uninstall introduction window appears.
3. Click Uninstall.
When the uninstallation process is complete, the Uninstall Complete window appears.
4. Click Done.

Uninstalling the Process Server in Graphical Mode 107


Uninstalling the Hub Server in Graphical Mode
You can uninstall the Hub Server in graphical mode.

Uninstalling the Hub Server in Graphical Mode on UNIX


To uninstall the MDM Hub, you must remove the Hub Server from the MDM Hub implementation.

1. Ensure that you stop the application server.


2. Navigate to the following directory:
<infamdm_install_directory>/hub/server/UninstallerData
3. Run the uninstaller.
./"Uninstall Informatica MDM Hub Server"
The Uninstall introduction window appears.
4. Click Uninstall.
When the uninstallation process is complete, the Uninstall Complete window appears.
5. Click Done.

Uninstalling the Hub Server in Graphical Mode on Windows


To uninstall the MDM Hub, you must remove the Hub Server from the MDM Hub implementation.

1. Ensure that you stop the application server.


2. Click Start and then click Programs > Infamdm > Hub > Server > UninstallerData > Uninstall
Informatica MDM Hub Server.
The Uninstall introduction window appears.
3. Click Uninstall.
When the uninstallation process is complete, the Uninstall Complete window appears.
4. Click Done.

Uninstalling the Resource Kit in Graphical Mode


You can uninstall the Resource Kit in graphical mode.

Uninstalling the Resource Kit in Graphical Mode on UNIX


To uninstall the Resource Kit, you must remove the Resource Kit from the MDM Hub implementation.

1. Stop the application server.


2. Navigate to the following directory:
<infamdm_install_directory>/hub/resourcekit/UninstallerData
3. Run the following command:
./"Uninstall Informatica MDM Hub Resource Kit"
The Uninstall Informatica MDM Hub Resource Kit window appears.

108 Chapter 10: Uninstallation


4. Click Uninstall.
The Uninstall Complete window appears with a list of items that could not be removed.
5. Click Done.
6. Manually remove the following directory:
<infamdm_install_dir>/hub/resourcekit

Uninstalling the Resource Kit in Graphical Mode on Windows


To uninstall the Resource Kit, you must remove the Resource Kit from the MDM Hub implementation.

1. Stop the application server.


2. Navigate to the following directory:
<ResourceKit_install_dir>\deploy\UninstallerData
3. Double-click Uninstall Informatica MDM Hub Resource Kit.exe
The Uninstall Informatica MDM Hub Resource Kit window appears.
4. Click Uninstall.
The Uninstall Complete window appears with a list of items that could not be removed.
5. Click Done.
6. Manually remove the following directory:
<infamdm_install_dir>\hub\resourcekit

Uninstalling the Process Server in Console Mode


You can uninstall the Process Server in console mode on UNIX. If you installed the Process Server in
console mode, uninstall the Process Server in console mode.

1. Go to the following directory:


<infamdm_install_dir>/hub/cleanse/UninstallerData
2. Type the following command to run the uninstaller:
./"Uninstall Informatica MDM Hub Cleanse Match Server"

Uninstalling the Hub Server in Console Mode


You can uninstall the Hub Server in console mode on UNIX. If you installed the Hub Server in console mode,
uninstall the Hub Server in console mode.

1. Go to the following directory:


<infamdm_install_dir>/hub/server/UninstallerData
2. Type the following command to run the uninstaller:
./"Uninstall Informatica MDM Hub Server"

Uninstalling the Process Server in Console Mode 109


Uninstalling the Resource Kit in Console Mode
You can uninstall the Resource Kit in console mode. If you installed the Resource Kit in console mode,
uninstall the Resource Kit in console mode.

1. Go to the following directory:


On UNIX. <infamdm_install_dir>/hub/resourcekit/UninstallerData
On Windows. <infamdm_install_dir>\hub\resourcekit\UninstallerData
2. Run the following command from the command prompt:
On UNIX. "Uninstall Informatica MDM Hub Resource Kit.bin" -i console
On Windows. "Uninstall Informatica MDM Hub Resource Kit.exe" -i console

Manually Undeploying the Process Server


You might need to manually undeploy the Process Server from the WebLogic Server environment.

u Use the WebLogic Server Administration Console to manually undeploy the siperian-mrmcleanse.ear
file.
For more information, see the WebLogic documentation.

Manually Undeploying the Hub Server


You might need to manually undeploy the Hub Server from the WebLogic Server environment.

u Use the WebLogic Server Administration Console to manually undeploy the siperian-mrm.ear file.
For more information, see the WebLogic documentation.

110 Chapter 10: Uninstallation


INDEX

A I
ActiveVOS Informatica ActiveVOS
adding users to the application server 67 creating the schema 34
URN, setting 68 Informatica platform
application server properties file 22
adding MDM Hub users 67 installation requirements
X Window Server 16
installing

C Hub Server 42, 45


Process Server 69, 71
clustering Resource Kit 92, 94
on WebLogic 19
custom jar files
repackaging 63
J
JBoss

D port conflicts 57
JBoss cache
databases configuring 63
target database 65 eviction 63
lockAcquisitionTimeout 63
mcast_addr 63

E mcast_port 63
stateRetrieval timeout 63
environment variables sync replTimeout 63
DISPLAY 16 wakeUpInterval 63
JMS message queues
configuring 60

G
graphical mode
installation requirements 16 L
log file
debug log file 54, 79

H Hub Server log file 55


installation log file 53, 77
Hub Console installation prerequisites log file 53, 79
starting 65 post install setup log file 54, 78
Hub Server Process Server log file 78
configuration properties 57 WebLogic Server log files 55, 80
deploying on WebLogic cluster 50
installation log files 52
installing 42, 45, 92
logging settings 56 M
postinstallsetup script 57 Master Database
silent installation 47, 50, 96 creating 36
silent properties file 47 importing metadata 38
uninstalling 109, 110 match population
version and build number 55 enabling 86
Hub Store MDM Hub
uninstalling 106 components 10
designing the installation 12
installation tasks 11
introduction 10
setting environment variables 16

111
MDM Hub (continued)
system requirements 15 S
message queues Sample Schema
adding to the module 61 installing 88
Microsoft SQL Server registering 90
configuring 17 silent installation
distributed transactions 17 of Hub Server 50
installing 17 silent installer
ODBC Driver 18 running 75
unixODBC Driver 18

O T
target database
Operational Reference Store selecting 65
creating 37 timeline
importing metadata 40 granularity 21
registering 65 troubleshooting
post-installation process 104

P
postinstallsetup script U
for Hub Server 57 uninstalling
for Process Server 82 Hub Server 109, 110
running 57, 82 Hub Store 106
Process Server Process Server 109
configuration properties 82 URN
configuring 81 setting ActiveVOS 68
deploying on WebLogic cluster 75
installation log files 77
installing 69, 71
logging settings 81 W
multithreading, configuring 83 WebLogic
postinstallsetup script 82 clustering 19
redeploying 82 configuring 18
silent installation 72 WebLogic cluster
silent properties file 73 deploying Hub Server 50
threads for batch processing 83 deploying Process Server 75
threads for cleanse operations 83 WebLogic Server
uninstalling 109 settings 57
version and build number 80

R X
X Window Server
Resource Kit installation requirements 16
installing 92, 94
silent properties file 97
uninstalling 109

112 Index

You might also like