Informatica 10.1 Metadata Manager Administrator Guide (English) MM 101 En

User Manual:

Open the PDF directly: View PDF PDF.
Page Count: 285 [warning: Documents this large are best viewed by clicking the View PDF Link!]

Informatica® (Version 10.1)
Metadata Manager
Administrator Guide
Informatica Metadata Manager Administrator Guide
Version 10.1
June 2016
© Copyright Informatica LLC 1993, 2017
This software and documentation contain proprietary information of Informatica LLC 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 LLC. 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,
Informatica Master Data Management, and Live Data Map are trademarks or registered trademarks of Informatica LLC 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 © 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. Copyright © jQWidgets. All rights reserved. Copyright © Tableau Software, Inc. All rights
reserved. Copyright© MaxMind, Inc. All Rights Reserved. Copyright © TMate Software s.r.o. All rights reserved. Copyright © MapR Technologies Inc. All rights reserved.
Copyright © Amazon Corporate LLC. All rights reserved. Copyright © Highsoft. All rights reserved. Copyright © Python Software Foundation. All rights reserved.
Copyright © BeOpen.com. All rights reserved. Copyright © CNRI. 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, <daniel@haxx.se>. All Rights Reserved. Permissions and limitations regarding this
software are subject to terms available at http://curl.haxx.se/docs/copyright.html. Permission to use, copy, modify, and distribute this software for any purpose with or
without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
The product includes software copyright 2001-2005 (©) MetaStuff, Ltd. All Rights Reserved. Permissions and limitations regarding this software are subject to terms
available at http://www.dom4j.org/ license.html.
The product includes software copyright © 2004-2007, The Dojo Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to
terms available at http://dojotoolkit.org/license.
This product includes ICU software which is copyright International Business Machines Corporation and others. All rights reserved. Permissions and limitations
regarding this software are subject to terms available at http://source.icu-project.org/repos/icu/icu/trunk/license.html.
This product includes software copyright © 1996-2006 Per Bothner. All rights reserved. Your right to use such materials is set forth in the license which may be found at
http:// www.gnu.org/software/ kawa/Software-License.html.
This product includes OSSP UUID software which is Copyright © 2002 Ralf S. Engelschall, Copyright © 2002 The OSSP Project Copyright © 2002 Cable & Wireless
Deutschland. Permissions and limitations regarding this software are subject to terms available at http://www.opensource.org/licenses/mit-license.php.
This product includes software developed by Boost (http://www.boost.org/) or under the Boost software license. Permissions and limitations regarding this software are
subject to terms available at http:/ /www.boost.org/LICENSE_1_0.txt.
This product includes software copyright © 1997-2007 University of Cambridge. Permissions and limitations regarding this software are subject to terms available at
http:// www.pcre.org/license.txt.
This product includes software copyright © 2007 The Eclipse Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to terms
available at http:// www.eclipse.org/org/documents/epl-v10.php 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; https://code.google.com/p/lz4/; https://github.com/jedisct1/libsodium/blob/master/LICENSE; http://one-jar.sourceforge.net/index.php?
page=documents&file=license; https://github.com/EsotericSoftware/kryo/blob/master/license.txt; http://www.scala-lang.org/license.html; https://github.com/tinkerpop/
blueprints/blob/master/LICENSE.txt; http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html; https://aws.amazon.com/asl/; https://github.com/
twbs/bootstrap/blob/master/LICENSE; https://sourceforge.net/p/xmlunit/code/HEAD/tree/trunk/LICENSE.txt; https://github.com/documentcloud/underscore-contrib/blob/
master/LICENSE, and https://github.com/apache/hbase/blob/master/LICENSE.txt.
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.
See patents at https://www.informatica.com/legal/patents.html.
DISCLAIMER: Informatica LLC 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 LLC 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.
Publication Date: 2017-04-21
Table of Contents
Preface ..................................................................... 12
Informatica Resources.................................................. 12
Informatica Network................................................. 12
Informatica Knowledge Base........................................... 12
Informatica Documentation............................................ 12
Informatica Product Availability Matrixes.................................... 13
Informatica Velocity................................................. 13
Informatica Marketplace.............................................. 13
Informatica Global Customer Support...................................... 13
Chapter 1: Using Metadata Manager.......................................... 14
Using Metadata Manager Overview.......................................... 14
Resource Types................................................... 14
Metadata Manager Architecture............................................ 15
Metadata Manager Service............................................ 16
Metadata Manager Application.......................................... 16
Metadata Manager Agent............................................. 16
Metadata Manager Repository.......................................... 17
PowerCenter Repository.............................................. 17
PowerCenter Integration Service......................................... 17
PowerCenter Repository Service......................................... 17
Custom Metadata Configurator.......................................... 17
Metadata Integration Process.............................................. 18
Resources....................................................... 18
Metadata Sources.................................................. 18
Informatica Metadata Extraction Interface................................... 18
PowerCenter Workflows.............................................. 18
Metadata Exchanges................................................ 19
Working with Metadata Manager............................................ 19
Metadata Manager Interface.............................................. 20
Load Tab........................................................ 20
Permissions Tab................................................... 20
Chapter 2: Configuring Metadata Manager.................................... 21
Configuring Metadata Manager Overview...................................... 21
Step 1. Create and Configure the Metadata Manager Service......................... 21
Step 2. Install the Metadata Manager Agent.................................... 22
Rules and Guidelines for the Metadata Manager Agent.......................... 22
Minimum System Requirements......................................... 23
Before You Install.................................................. 23
4 Table of Contents
Installing the Metadata Manager Agent..................................... 23
After You Install.................................................... 24
Working with a Keystore File........................................... 26
Chapter 3: Application Resources............................................ 28
SAP R/3 Resource Overview.............................................. 28
Configuring SAP R/3................................................... 28
Install Transports................................................... 28
Configure a User Authorization Profile..................................... 29
Install the SAP JCo Libraries........................................... 29
Creating an SAP R/3 Resource............................................. 29
SAP R/3 Configuration Properties........................................ 31
Configuring the Component Inclusion List...................................... 31
Reference.......................................................... 31
Version......................................................... 31
Objects Extracted.................................................. 32
Data Lineage..................................................... 32
SAP R/3 Schema Class.............................................. 32
Chapter 4: Business Glossary Resources..................................... 33
Business Glossary Resources Overview....................................... 33
Application Services Verification............................................ 34
Creating a Business Glossary Resource....................................... 34
Business Glossary Connection Properties................................... 35
Business Glossary Objects Extracted......................................... 36
Business Glossary Objects Not Extracted...................................... 36
Chapter 5: Business Intelligence Resources.................................. 38
Business Objects...................................................... 38
Configuring Business Objects........................................... 38
Creating a Business Objects Resource..................................... 40
Reference....................................................... 43
Cognos............................................................ 46
Configuring Cognos................................................. 46
Creating a Cognos Resource........................................... 47
Reference....................................................... 51
Microsoft Analysis and Reporting Services..................................... 52
Configuring Microsoft Analysis and Reporting Services.......................... 53
Creating a Microsoft Analysis and Reporting Services Resource.................... 54
Reference....................................................... 56
Microstrategy........................................................ 58
Configuring Microstrategy............................................. 58
Creating a Microstrategy Resource....................................... 59
Table of Contents 5
Reference....................................................... 62
Oracle Business Intelligence Enterprise Edition.................................. 64
Configuring Oracle Business Intelligence Enterprise Edition....................... 64
Creating an Oracle Business Intelligence Enterprise Edition Resource................ 66
Reference....................................................... 68
SAP Business Warehouse................................................ 70
Configuring SAP Business Warehouse..................................... 71
Creating an SAP Business Warehouse Resource.............................. 72
Reference....................................................... 74
Tableau............................................................ 77
Configuring Tableau................................................. 77
Creating a Tableau Resource........................................... 78
Reference....................................................... 80
Incremental Metadata Load ............................................... 81
Adding or Removing Metadata Files for a Resource............................... 82
Chapter 6: Custom Resources................................................ 84
Configuring Custom Metadata Sources........................................ 84
Creating a Custom Resource.............................................. 84
Configuring the Template Name............................................ 85
Adding or Removing Metadata Files for a Resource............................... 85
Chapter 7: Data Integration Resources........................................ 87
Informatica Platform Resources............................................ 87
Configuring the Metadata Source........................................ 88
Creating an Informatica Platform Resource.................................. 88
Command Line Utilities Installation for Version 10.0 Applications.................... 91
Parameters in Informatica Platform 10.x Resources............................ 92
Parameters in Informatica Platform 9.5.1 - 9.6.x Resources....................... 93
Reference....................................................... 94
Microsoft SQL Server Integration Services Resources.............................. 99
Metadata Extraction from Protected Packages............................... 100
Configuring SQL Server Integration Services................................ 100
Creating an SQL Server Integration Services Resource......................... 102
Reference...................................................... 105
PowerCenter Resources................................................ 110
Configuring PowerCenter............................................. 110
Creating a PowerCenter Resource....................................... 112
Configuring the Folder Inclusion List...................................... 115
Configuring the Source Increment Extract Window............................ 116
PowerCenter Parameter Files.......................................... 116
Reference...................................................... 119
6 Table of Contents
Chapter 8: Data Modeling Resources........................................ 123
Embarcadero ERStudio................................................. 123
Configuring Embarcadero ERStudio...................................... 123
Creating an Embarcadero ERStudio Resource............................... 124
Reference...................................................... 126
ERwin............................................................ 129
Configuring ERwin................................................. 129
Creating an ERwin Resource.......................................... 130
Reference...................................................... 137
SAP PowerDesigner................................................... 140
Configuring SAP PowerDesigner........................................ 140
Creating an SAP PowerDesigner Resource................................. 140
Reference...................................................... 143
Adding or Removing Metadata Files for a Resource............................... 143
Reference for Data Modeling Resources...................................... 144
Datatypes....................................................... 144
Validation Rules.................................................. 145
Relationships.................................................... 145
View Associations................................................. 145
Schema and Owners............................................... 145
Name and Description Properties....................................... 145
Multiple Models in the Same Repository................................... 146
Objects Not Extracted............................................... 146
Domain-to-Validation Rule Association.................................... 146
Chapter 9: Database Management Resources................................ 147
Cloudera Navigator................................................... 147
Maximum Heap Size Configuration...................................... 148
Creating a Cloudera Navigator Resource................................... 148
Filtering for Hive and Impala Query Templates ............................... 150
Incremental Loading for Cloudera Navigator Resources......................... 151
Search Queries................................................... 151
Reference...................................................... 153
IBM DB2 for LUW..................................................... 158
Configuring IBM DB2 for LUW.......................................... 158
Creating an IBM DB2 for LUW Resource................................... 160
Reference...................................................... 163
IBM DB2 for z/OS.................................................... 164
Configuring IBM DB2 for z/OS......................................... 164
Creating an IBM DB2 for z/OS Resource................................... 166
Reference...................................................... 168
IBM Informix........................................................ 169
Table of Contents 7
Configuring IBM Informix............................................. 169
Creating an IBM Informix Resource...................................... 171
Reference...................................................... 172
JDBC............................................................ 174
Configuring the JDBC Metadata Source................................... 174
Creating a JDBC Resource........................................... 175
Objects Extracted and Not Extracted ..................................... 177
Microsoft SQL Server.................................................. 178
Configuring Microsoft SQL Server....................................... 178
Creating a Microsoft SQL Server Resource................................. 179
Reference...................................................... 181
Netezza........................................................... 183
Configuring Netezza................................................ 183
Creating a Netezza Resource.......................................... 184
Reference...................................................... 186
Oracle............................................................ 186
Configure Permissions.............................................. 187
Configure Oracle with the Advanced Security Option ........................... 188
Creating an Oracle Resource.......................................... 189
Incremental Loading for Oracle Resources................................. 192
Reference...................................................... 192
Sybase ASE........................................................ 193
Configuring Sybase ASE............................................. 194
Creating a Sybase ASE Resource....................................... 195
Reference...................................................... 196
Teradata.......................................................... 197
Configuring Teradata............................................... 197
Creating a Teradata Resource......................................... 198
Incremental Loading for Teradata Resources................................ 200
Reference...................................................... 200
Configuring the Schema Inclusion List....................................... 202
Data Lineage for Database Management Resources.............................. 203
Tables in Join Statements............................................ 203
SQL Inline Views.................................................. 203
Chapter 10: Universal Resources............................................ 204
Universal Resources Overview............................................ 204
Supported Metadata Sources............................................. 205
XConnect Creation.................................................... 206
Step 1. Get the Metadata Source Name................................... 207
Step 2. Create the Plug-in Definition File................................... 208
Step 3. Get the Image Mapping Information................................. 209
Step 4. Get the Icons............................................... 210
8 Table of Contents
Step 5. Generate the Plug-in.......................................... 211
Step 6. Create the Model from the Plug-in.................................. 212
Updating a Universal XConnect......................................... 213
Deleting a Universal XConnect......................................... 213
Resource Creation.................................................... 213
Step 1. Configure the Metadata Source.................................... 213
Step 2. Create the Resource.......................................... 215
Chapter 11: Managing Resources............................................ 217
Managing Resources Overview............................................ 217
Configure Connection Assignments......................................... 218
Automatic Connection Assignments...................................... 218
Manual Connection Assignments........................................ 219
Connection Assignments Example....................................... 219
Connection Assignment Properties...................................... 220
Automatically Configuring Connection Assignments............................ 220
Manually Configuring Connection Assignments............................... 221
Upload Rule Sets..................................................... 221
Linking Rules Files................................................. 222
Uploading a Rule Set............................................... 223
Purging Metadata..................................................... 223
Refreshing the Resources Panel........................................... 224
Updating the Search Index............................................... 224
Automatic Index Updates............................................. 225
Optimizing the Index................................................ 225
Manually Creating Indexes............................................ 225
Troubleshooting the Search Index....................................... 225
Customizing the List of Words to Ignore in Searches.............................. 226
Chapter 12: Loading and Monitoring Resources.............................. 228
Loading and Monitoring Resources Overview................................... 228
Loading Resources................................................... 229
Loading a Resource................................................ 229
Load Queue..................................................... 229
Resuming a Failed Resource Load...................................... 230
Linking Objects Across Resources.......................................... 230
Creating Links for a Resource.......................................... 230
Link Status...................................................... 231
Rules and Guidelines for Creating Links................................... 231
Monitoring Resources.................................................. 232
Viewing Load Details............................................... 232
Viewing Link Details................................................ 235
Load Details Log File............................................... 237
Table of Contents 9
Logs and Log Files.................................................... 237
Metadata Manager Agent Log File....................................... 238
Metadata Manager Service Log File...................................... 239
Activity Log...................................................... 240
Troubleshooting Resource Loads.......................................... 240
Scheduling Resource Loads.............................................. 241
Creating a Schedule................................................ 242
Editing a Schedule................................................. 243
Attaching a Schedule to a Resource...................................... 243
Chapter 13: Managing Permissions.......................................... 244
Managing Permissions Overview........................................... 244
Users and Groups................................................. 245
Permissions..................................................... 245
Rules and Guidelines for Permissions..................................... 245
Configuring Permissions for Users and Groups.................................. 246
Configuring Permissions on the Metadata Catalog................................ 246
Chapter 14: Resource Migration............................................. 248
Resource Migration Overview............................................. 248
Resource Migration Steps............................................... 248
Step 1. Copy the Plug-in for a Universal XConnect............................... 250
Step 2. Migrate the Model............................................... 250
Exporting a Packaged or Universal Model.................................. 251
Importing a Packaged or Universal Model.................................. 251
Step 3. Migrate the Resource Configuration.................................... 251
Exporting a Resource Configuration...................................... 252
Importing a Resource Configuration...................................... 252
Step 4. Load the Resource............................................... 253
Step 5. Migrate Resource Metadata......................................... 253
Exporting Resource Metadata.......................................... 254
Importing Resource Metadata.......................................... 254
Chapter 15: Repository Migration............................................ 255
Repository Migration Overview............................................ 255
Migrating the Repository when Domain Names and Encryption Keys are the Same.......... 255
Migrating the Repository when Domain Names or Encryption Keys Differ................. 256
Appendix A: Metadata Manager Login....................................... 258
Metadata Manager Login Overview......................................... 258
Cookies........................................................... 258
Logging in to Metadata Manager........................................... 259
Changing a Password.................................................. 259
10 Table of Contents
Appendix B: Metadata Manager Properties Files.............................. 260
imm.properties...................................................... 260
Metadata Manager Application Properties.................................. 260
Data Lineage Properties............................................. 263
searchpriorities.xml................................................... 264
Search Result Configuration........................................... 265
Sample searchpriorities.xml File........................................ 265
Appendix C: Resource Configuration Files................................... 267
Resource Configuration Files Overview....................................... 267
Resource Configuration File Format......................................... 268
Passwords in Resource Configuration Files.................................... 268
Secure JDBC Parameters in Resource Configuration Files.......................... 269
Sample Resource Configuration File........................................ 270
Appendix D: Glossary....................................................... 272
Index........................................................... 278
Table of Contents 11
Preface
The Metadata Manager Administrator Guide provides information about how to configure Metadata Manager,
create and load resources, and perform other Metadata Manager administration functions.
Informatica Resources
Informatica Network
Informatica Network hosts Informatica Global Customer Support, the Informatica Knowledge Base, and other
product resources. To access Informatica Network, visit https://network.informatica.com.
As a member, you can:
Access all of your Informatica resources in one place.
Search the Knowledge Base for product resources, including documentation, FAQs, and best practices.
View product availability information.
Review your support cases.
Find your local Informatica User Group Network and collaborate with your peers.
Informatica Knowledge Base
Use the Informatica Knowledge Base to search Informatica Network for product resources such as
documentation, how-to articles, best practices, and PAMs.
To access the Knowledge Base, visit https://kb.informatica.com. If you have questions, comments, or ideas
about the Knowledge Base, contact the Informatica Knowledge Base team at
KB_Feedback@informatica.com.
Informatica Documentation
To get the latest documentation for your product, browse the Informatica Knowledge Base at
https://kb.informatica.com/_layouts/ProductDocumentation/Page/ProductDocumentSearch.aspx.
If you have questions, comments, or ideas about this documentation, contact the Informatica Documentation
team through email at infa_documentation@informatica.com.
12
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. If you are an Informatica Network member, you
can access PAMs at
https://network.informatica.com/community/informatica-network/product-availability-matrices.
Informatica Velocity
Informatica Velocity is a collection of tips and best practices developed by Informatica Professional Services.
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 are an Informatica Network member, you can access Informatica Velocity resources at
http://velocity.informatica.com.
If you have questions, comments, or ideas about Informatica Velocity, contact Informatica Professional
Services at ips@informatica.com.
Informatica Marketplace
The Informatica Marketplace is a forum where you can find solutions that augment, extend, or enhance your
Informatica implementations. By leveraging any of the hundreds of solutions from Informatica developers and
partners, you can improve your productivity and speed up time to implementation on your projects. You can
access Informatica Marketplace at https://marketplace.informatica.com.
Informatica Global Customer Support
You can contact a Global Support Center by telephone or through Online Support on Informatica Network.
To find your local Informatica Global Customer Support telephone number, visit the Informatica website at the
following link: http://www.informatica.com/us/services-and-training/support-services/global-support-centers.
If you are an Informatica Network member, you can use Online Support at http://network.informatica.com.
Preface 13
CHAPTER 1
Using Metadata Manager
This chapter includes the following topics:
Using Metadata Manager Overview, 14
Metadata Manager Architecture, 15
Metadata Integration Process, 18
Working with Metadata Manager, 19
Metadata Manager Interface, 20
Using Metadata Manager Overview
Informatica Metadata Manager is a web-based metadata management tool that you can use to browse and
analyze metadata from disparate metadata repositories. Metadata Manager helps you understand and
manage how information and processes are derived. It also helps you understand the fundamental
relationships between information and processes, and how they are used.
Metadata Manager extracts metadata from application, business glossary, business intelligence, custom,
data integration, data modeling, and relational metadata sources. It uses PowerCenter workflows to extract
metadata from metadata sources and load it into a centralized metadata warehouse called the Metadata
Manager warehouse.
Use Metadata Manager to browse and search the Metadata Manager warehouse and run data lineage
analysis for the metadata in the Metadata Manager warehouse.
Metadata Manager runs as a service in an Informatica domain. Create a Metadata Manager Service in
Informatica Administrator to configure and run the Metadata Manager application.
Resource Types
You can use Metadata Manager to extract and analyze metadata for different types of resources.
The following table lists the resource types and the associated metadata source types for which you can
extract and analyze metadata:
Metadata Source Type Resource Type
Application SAP R/3
Business Glossary Business Glossary
14
Metadata Source Type Resource Type
Business Intelligence Business Objects
Cognos
Microsoft Analysis and Reporting Services
Microstrategy
Oracle Business Intelligence Enterprise Edition (OBIEE)
SAP Business Warehouse
Tableau
Custom Custom
Data Integration Informatica Platform
Microsoft SQL Server Integration Services
PowerCenter
Data Modeling Embarcadero ERStudio
ERwin
SAP PowerDesigner
Database Management Cloudera Navigator
IBM DB2 for Linux, UNIX, and Windows
IBM DB2 for z/OS
IBM Informix
JDBC
Microsoft SQL Server
Netezza
Oracle
Sybase ASE
Teradata
Other (non-custom) business intelligence, data integration, data
modeling, or database management metadata sources
Universal
For more information about supported metadata source versions, see the PCAE Metadata Manager
XConnect Support Product Availability Matrix on Informatica Network:
https://network.informatica.com/community/informatica-network/product-availability-matrices/overview
Metadata Manager Architecture
Metadata Manager runs as an application service in an Informatica domain. The Metadata Manager
architecture includes the following components:
Metadata Manager Service
Metadata Manager application
Metadata Manager Agent
Metadata Manager repository
Metadata Manager Architecture 15
PowerCenter repository
PowerCenter Integration Service
PowerCenter Repository Service
Custom Metadata Configurator
The following figure shows the Metadata Manager components:
Metadata Manager Service
An application service in an Informatica domain that runs the Metadata Manager application and manages
connections between the Metadata Manager components. Create and configure the Metadata Manager
Service in Informatica Administrator. The Metadata Manager Service manages the configuration information
for Metadata Manager, including application properties and PowerCenter Integration Service, PowerCenter
Repository Service, and Metadata Manager repository configuration information.
Start and stop the Metadata Manager application by enabling and disabling the Metadata Manager Service in
Informatica Administrator. When you enable a Metadata Manager Service, the Service Manager on the node
where the Metadata Manager Service runs starts the Metadata Manager application.
Metadata Manager Application
A web-based application that manages the metadata in the Metadata Manager warehouse. Use the Metadata
Manager application to create and load resources in Metadata Manager. After you load metadata for a
resource, you can use the Metadata Manager application to browse and analyze metadata for the resource.
You can also use the Metadata Manager application to create custom models and manage security on the
metadata in the Metadata Manager warehouse. You must create a Metadata Manager Service to access the
Metadata Manager application.
Metadata Manager Agent
The Metadata Manager Agent extracts metadata from metadata sources and converts it to the Informatica
Metadata Extraction (IME) interface format. The Metadata Manager Agent runs on Windows either within the
Metadata Manager application or separately.
By default, the Metadata Manager Agent runs on the Windows machines where the Metadata Manager
Service runs. You can also install the Metadata Manager Agent separately.
You must install the Metadata Manager Agent separately in the following circumstances:
16 Chapter 1: Using Metadata Manager
When you extract metadata from some business intelligence, data integration, data modeling, or JDBC metadata sources.
To extract metadata from some business intelligence, data integration, data modeling, or JDBC
metadata sources, you must install the Metadata Manager Agent on the machine that runs the vendor
supplied software. For example, to extract metadata from Microstrategy, the Metadata Manager Agent
and the Microstrategy client must be on the same machine. For information about extracting metadata
from business intelligence and data modeling resources, see the documentation for the resource type
that you want to create.
When the domain uses Kerberos authentication.
When the domain uses Kerberos authentication and the Metadata Manager Service runs on Windows,
you must install the Metadata Manager Agent separately. You can install the Metadata Manager Agent
separately on the same machine where the Metadata Manager Service runs, or you can install it on
another Windows machine.
When the Metadata Manager Service runs on UNIX.
You must install the Metadata Manager Agent on a Windows machine. The Metadata Manager Agent
does not run on UNIX.
Metadata Manager Repository
A centralized location in a relational database that stores metadata from disparate metadata sources. It also
stores the Metadata Manager warehouse and the models for each metadata source type. Each Metadata
Manager application is configured to run with one Metadata Manager repository. You create the Metadata
Manager repository when you create the Metadata Manager Service.
When you load metadata for a resource, Metadata Manager loads the metadata into the Metadata Manager
warehouse. When you browse or analyze metadata in Metadata Manager, Metadata Manager queries the
warehouse to display the metadata.
PowerCenter Repository
Stores the PowerCenter workflows, which extract source metadata from IME-based files and load it into the
Metadata Manager warehouse. You create the PowerCenter repository when you create the Metadata
Manager Service. You can use an existing PowerCenter repository in an Informatica domain to store the
workflows, or you can create a PowerCenter repository specifically for use with Metadata Manager.
PowerCenter Integration Service
Runs the workflows that extract the metadata from IME-based files and load it into the Metadata Manager
warehouse. You configure the PowerCenter Integration Service that you want to use with Metadata Manager
when you create the Metadata Manager Service.
PowerCenter Repository Service
Manages connections to the PowerCenter repository that stores the workflows that extract metadata from
IME interface-based files. Metadata Manager uses the PowerCenter Repository Service associated with the
PowerCenter Integration Service that you configure for the Metadata Manager Service.
Custom Metadata Configurator
Creates custom resource templates and PowerCenter workflows to extract metadata from metadata sources
for which Metadata Manager does not package a resource type.
Metadata Manager Architecture 17
Metadata Manager packages resource types that extract metadata from metadata sources. You can also
extract metadata from a metadata source for which Metadata Manager does not package a resource type.
You create a model for the metadata source in Metadata Manager and use the Custom Metadata
Configurator to create a custom template and PowerCenter workflows to load the metadata into the Metadata
Manager warehouse.
Metadata Integration Process
Metadata Manager uses Metadata Exchanges to load metadata from different metadata sources into the
Metadata Manager warehouse. To run a Metadata Exchange, you create a resource in Metadata Manager
that represents the metadata source. When you load the resource, Metadata Manager uses the Metadata
Exchange for the resource to extract and load the metadata.
The Metadata Exchanges use the Metadata Manager Agent to extract the source metadata and reformat it
into a usable format, the IME interface format. The Metadata Exchanges then use the PowerCenter
workflows, consisting of worklets, sessions, and mappings, to extract, transform, and load metadata from the
IME-formatted files to the Metadata Manager warehouse.
This entire process is known as the metadata integration process. The PowerCenter repository contains the
workflows that extract and load the source repository metadata.
Resources
Resources represent metadata sources in Metadata Manager. Each resource contains the properties
required to connect to a metadata source, extract metadata from the source, and load the extracted metadata
into the Metadata Manager warehouse. Metadata Manager stores the resources you create in the Metadata
Manager repository.
Metadata Sources
Metadata sources contain the source metadata that you want to browse and analyze using Metadata
Manager. For example, an RDBMS repository is a relational database catalog source repository that contains
metadata, such as schemas, tables, views, and columns.
Create resources to extract metadata from a metadata source and load it into the Metadata Manager
warehouse.
Informatica Metadata Extraction Interface
Metadata Manager uses a preliminary process to restructure the source metadata into a format required by
the mappings within each PowerCenter workflow. The method used to restructure the metadata can vary. For
example, if the source repository is a database repository, Metadata Manager uses database views to
restructure the metadata into the required IME format.
Metadata Manager uses PowerExchange to access metadata in an IBM DB2 for z/OS subsystem.
PowerCenter Workflows
After the source metadata is converted into the IME format, the PowerCenter Integration Service uses
PowerCenter workflows to extract the metadata from the IME-based files and load it into the Metadata
Manager warehouse.
18 Chapter 1: Using Metadata Manager
Metadata Exchanges
Metadata Manager uses Metadata Exchanges to extract source metadata and load it into the Metadata
Manager warehouse.
Each Metadata Exchange contains the following components:
IME-based transformation component. The PowerCenter workflows require the source metadata to be
in a particular format. Metadata Manager packages a transformation process for each Metadata Exchange
to transform the source metadata based on the required IME format. The transformation process stores
the transformed metadata in files or database views that are prefixed with IME. The files are called IME
files and the views are called IME views.
Load component. The load component consists of PowerCenter workflows that extract the source
metadata in the required IME format and load it into the Metadata Manager warehouse. The PowerCenter
repository contains all the PowerCenter workflows required to extract, transform, and load the source
metadata.
When you load source metadata into the Metadata Manager warehouse, Metadata Manager performs the
IME-based transformation on the source metadata. Metadata Manager then issues a command to the
PowerCenter Integration Service to run the applicable workflows. The workflows load the IME-formatted
source metadata into the Metadata Manager warehouse.
Metadata Manager provides Metadata Exchanges that are configured to extract metadata from particular
types of metadata sources.
You can develop custom resources to load metadata from a metadata source for which Metadata Manager
does not package a resource type. For example, Metadata Manager does not provide a resource type for
Microsoft Access databases. To extract metadata from an Access database, you must create a custom model
and resource.
Working with Metadata Manager
Before you can browse and search metadata in the Metadata Manager warehouse, you must configure
Metadata Manager and create and load resources.
Complete the following steps to load metadata from a metadata source into the Metadata Manager
warehouse:
1. Set up Metadata Manager. Create a Metadata Manager Service and install the Metadata Manager
Agent.
2. Create and configure resources. Create resources that represent the metadata sources from which
you want to extract metadata. Configure parameters and connection assignments for the resources.
3. Manage resources. Purge metadata for a previously loaded resource and update the index for
resources.
4. Load and monitor resources. Load a resource to load the metadata for the resource into the Metadata
Manager warehouse. When you load a resource, Metadata Manager extracts and loads the metadata for
the resource. If you modify connection assignments after loading a resource, create links between
objects in connected resources. You can monitor the status of all resources and the status of individual
resources. You can also schedule resource loads.
5. Manage resource and object permissions for Metadata Manager users. You can configure the
resources and metadata objects in the warehouse for which Metadata Manager users have access.
You can use Metadata Manager command line programs to load resources, monitor the status of resource
loads, and back up and restore the Metadata Manager repository.
Working with Metadata Manager 19
Related Topics:
“Configuring Metadata Manager Overview” on page 21
“Managing Resources” on page 217
“Loading and Monitoring Resources” on page 228
“Managing Permissions” on page 244
Metadata Manager Interface
The Metadata Manager interface consists of the following tabs:
Browse
Browse and search the metadata catalog, view business glossaries, and run data lineage analysis. For
more information about the Browse tab, see the Metadata Manager User Guide.
Model
View models, add custom attributes to models, and create, edit, import, and export custom models. For
more information about the Model tab, see the Metadata Manager Custom Metadata Integration Guide.
Load
Create and load resources to load metadata into the Metadata Manager warehouse. Use the Load tab to
monitor and schedule resource loads, purge metadata from the Metadata Manager warehouse, and
manage the search index.
Permissions
Manage permissions on resources and metadata objects in the Metadata Manager warehouse.
Load Tab
The Load tab has the following components:
Actions menu. Use the Actions menu to create, edit, and delete resources, load resources, create
schedules and add schedules to resources, view the Metadata Manager activity log, create links between
resources, index resources, and download the Metadata Manager Agent installer.
Resources panel. Shows the list of configured resources in the Metadata Manager repository. Use this
panel to create and delete resources, refresh the resource list, load, resume, and cancel resource loads,
create links between resources, purge metadata for a resource, and monitor resource loads.
Resource Properties panel. View the configuration properties for resources and configure name and
description, connection information, parameters, schedules, and connection assignments for resources.
Permissions Tab
The Permissions tab has the following components:
Navigator. Navigate the resources, metadata objects, groups and users that you can configure
permissions for.
Permissions panel. Configure permissions for groups and users, and configure permissions for
resources and metadata objects in the metadata catalog.
20 Chapter 1: Using Metadata Manager
CHAPTER 2
Configuring Metadata Manager
This chapter includes the following topics:
Configuring Metadata Manager Overview, 21
Step 1. Create and Configure the Metadata Manager Service, 21
Step 2. Install the Metadata Manager Agent, 22
Configuring Metadata Manager Overview
Before you log in to Metadata Manager and load metadata into the Metadata Manager warehouse, you must
configure Metadata Manager.
Complete the following tasks to configure Metadata Manager:
1. Create and configure the Metadata Manager Service. Create and configure the Metadata Manager
Service in Informatica Administrator.
2. Install the Metadata Manager Agent. Download the Metadata Manager Agent installer and install the
agent. Install the agent on machines where the source files or source repositories for certain metadata
sources are located.
After you configure Metadata Manager, you can log in to the application, create resources, and load
metadata into the Metadata Manager warehouse. You must also log in to Metadata Manager to download the
Metadata Manager Agent installer.
Step 1. Create and Configure the Metadata Manager
Service
The Metadata Manager Service runs the Metadata Manager application and manages the Metadata Manager
application properties. Create and manage the Metadata Manager Service in Informatica Administrator. You
create the service and the repositories required by Metadata Manager. You configure properties such as the
node and port number where Metadata Manager runs.
You also create users and groups for Metadata Manager in Informatica Administrator. After you create and
enable the Metadata Manager Service, you can manage users and groups in Informatica Administrator.
21
Step 2. Install the Metadata Manager Agent
The Metadata Manager Agent is a program that Metadata Manager uses to access metadata sources and
extract source metadata.
By default, the Metadata Manager Agent runs on the Windows node where the Metadata Manager Service
runs. It uses one port number higher than the Metadata Manager Service. You can configure the port number
in the Administrator tool. A separate instance of the Metadata Manager Agent runs for each Metadata
Manager Service on a node. The agent runs in the following directory:
<Informatica installation directory>\services\MetadataManagerService\mmagentapps\mmagent\
You can also install the Metadata Manager Agent separately on the same machine where the Metadata
Manager service runs or on another Windows machine.
You must install the Metadata Manager Agent separately in the following circumstances:
When you extract metadata from some business intelligence, data integration, data modeling, or JDBC metadata sources.
To extract metadata from some business intelligence, data integration, data modeling, or JDBC
metadata sources, you must install the Metadata Manager Agent on the machine that runs the vendor
supplied software. For example, to extract metadata from Microstrategy, the Metadata Manager Agent
and the Microstrategy client must be on the same machine. For information about extracting metadata
from business intelligence and data modeling resources, see the documentation for the resource type
that you want to create.
When the domain uses Kerberos authentication.
When the domain uses Kerberos authentication and the Metadata Manager Service runs on Windows,
you must install the Metadata Manager Agent separately. You can install the Metadata Manager Agent
separately on the same machine where the Metadata Manager Service runs, or you can install it on
another Windows machine.
When the Metadata Manager Service runs on UNIX.
You must install the Metadata Manager Agent on a Windows machine. The Metadata Manager Agent
does not run on UNIX.
Rules and Guidelines for the Metadata Manager Agent
Use the following rules and guidelines when you install the Metadata Manager Agent:
Install the Metadata Manager Agent on a Windows machine if the Metadata Manager Service runs on UNIX.
The Metadata Manager Agent runs on Windows. If the Metadata Manager Service runs on UNIX, you
must install the Metadata Manager Agent on a separate Windows machine. If the Metadata Manager
Service runs on Windows, the Metadata Manager Agent is installed as part of the Metadata Manager
Service installation.
Configure the Metadata Manager Agent to run in HTTP or HTTPS.
Configure the Metadata Manager Agent to run in HTTP or HTTPS (HTTP security mode). The mode of
the Metadata Manager Agent that you install must be the same security mode as the Metadata Manager
Service. You must generate the keystore file to use with HTTPS.
If the Oracle Business Intelligence Enterprise Edition (OBIEE) Presentation Server runs in HTTPS mode,
configure HTTPS mode for the Metadata Manager Agent.
You can stop and start the Metadata Manager Agent.
The Metadata Manager Agent starts as a Windows service after you install it. You can stop or start the
Metadata Manager Agent from the Windows Start menu or from the Windows Services panel.
22 Chapter 2: Configuring Metadata Manager
Alternately, you can run the Metadata Manager Agent from the command prompt. The batch files that
start and stop the Metadata Manager Agent are in the Metadata Manager Agent installation directory.
You can install the Metadata Manager Agent on 32-bit and 64-bit Windows machines.
The Metadata Manager Agent can run on 32-bit and 64-bit Windows machines. By default, the Metadata
Manager Agent configures a 1 GB maximum Java Virtual Machine (JVM) heap size on a 32-bit machine.
It configures a 4 GB maximum JVM heap size on a 64-bit machine.
Minimum System Requirements
The following table describes the minimum system requirements to run the Metadata Manager Agent:
Processor RAM Disk Space
1 CPU 512 MB 220 MB
For information about the operating systems on which you can install the Metadata Manager Agent, see the
Product Availability Matrix on Informatica Network:
https://network.informatica.com/community/informatica-network/product-availability-matrices/overview .
Before You Install
Before you install the Metadata Manager Agent, verify that the user account you use to install the agent is a
member of the Windows administrator group on the machine where you install the agent. The user account
must have the Log on as a service and Act as operating system permissions.
Installing the Metadata Manager Agent
To install the Metadata Manager Agent:
1. Log in to Metadata Manager.
2. On the Load tab, click Actions > Download Agent Installer.
The browser prompts you to download MMAgentInstaller.exe.
3. Save the file to your hard drive.
4. Copy the installer to the machine where you want to install the Metadata Manager Agent.
5. Double-click MMAgentInstaller.exe to begin the installation.
The Introduction window appears.
6. Click Next.
The Agent Configuration page appears.
Step 2. Install the Metadata Manager Agent 23
7. Configure the following options:
Option Description
HTTP port Port number used by Metadata Manager to communicate with the Metadata Manager Agent.
Default is 19983.
Agent home Directory where you want to install the Metadata Manager Agent. Default is c:\informatica
\<current version>\MetadataManagerAgent.
You can use the default installation directory or click Browse to select a directory.
8. Click Next.
The HTTPS Configuration window appears.
9. Clear the HTTPS option if you do not want to use HTTPS. Skip to step 11.
10. Enter the following information to use HTTPS:
Option Description
HTTPS Port Number Port used by the node to communicate between the Metadata Manager Agent and the
Metadata Manager application.
Keystore Password A plain-text password for the keystore file.
Keystore File Location A file that includes private or public key pairs and associated certificates. You can use a
self-signed certificate or a certificate signed by a certificate authority. If you use a different
keystore file than the Metadata Manager Service, you must import the Metadata Manager
Agent keystore certificate with the Metadata Manager Service keystore file.
11. Click Next.
The Pre-Installation Summary window appears.
12. Verify the installation options and click Install.
The installer completes the installation and installs the Metadata Manager Agent as a Windows service
named Metadata Manager Agent <version>.
13. Click Done.
Related Topics:
“Merging Certificates” on page 26
After You Install
After you install the Metadata Manager Agent, you must complete some post-installation tasks.
Complete the following tasks:
Verify the Metadata Manager Agent connectivity with the Metadata Manager Service.
Enable the Metadata Manager Agent to interact with the desktop for Business Objects, Microstrategy,
ERwin 7.x, ERwin 8.x, or ERwin 9.x.
Optionally increase the Java Virtual Manager (JVM) memory.
24 Chapter 2: Configuring Metadata Manager
Verify Metadata Manager Agent Connectivity
The Metadata Manager Agent uses HTTP to communicate with the Metadata Manager Service when you
load a resource.
Metadata Manager Agent connects to the Metadata Manager Service using the default port 19983 or any port
you specify in the Tomcat configuration file, server.xml. You can verify or update the port number in the
Tomcat configuration file that is available in the following location:
<INFA_HOME>\MetadataManagerAgent\tomcat\conf\
After you install the Metadata Manager Agent, verify that the agent and the Metadata Manager Service can
communicate.
You can use one of the following options to verify that the agent and the Metadata Manager Service can
communicate:
Run the following command on the machine where the Metadata Manager Service runs:
telnet <Metadata Manager Agent machine name> <Metadata Manager Agent port>
Connect to the Metadata Manager Agent from a web browser using the following URL:
http://server:port/MIMBWebServices
If the Metadata Manager Agent is running, the home page of the agent appears.
If the commands fails, make sure that the Metadata Manager Service and the Metadata Manager Agent
service are available. If the machines are separated by a firewall, contact the administrator to make the port
numbers available.
Enable the Metadata Manager Agent to Interact with the Desktop
If you run the Metadata Manager Agent as a service, you must enable the Metadata Manager Agent to
interact with the desktop.
You must enable the Metadata Manager Agent to interact with the desktop for the following metadata
sources:
Business Objects
Microstrategy
ERwin 7.x, 8.x, and 9.x
1. From the Windows Start menu, click Administrative Tools > Services.
2. Double-click Metadata Manager Agent.
The Metadata Manager Agent <Version> Properties dialog box appears.
3. Click the Log On tab.
4. Under Local System Account, click Allow service to interact with desktop.
5. Click OK.
Increase Java Virtual Machine Memory
If you want to load a large amount of metadata for a resource type that uses the Metadata Manager Agent,
you can increase the Java Virtual Machine (JVM) heap size to increase scalability. By default, the Metadata
Step 2. Install the Metadata Manager Agent 25
Manager Agent configures a 1 GB maximum heap size on a 32-bit machine, and it configures a 4 GB
maximum heap size on a 64-bit machine.
You may need to increase the JVM heap size when you extract from a large or complex source environment
and receive an error message that says there is not enough available storage to process the command.
Increase the heap size in the MIRSetup.xml file.
1. Use a text editor to open MIRSetup.xml from the following location:
<Metadata Manager Agent installation directory>\conf
2. Edit the -Xmx option in the <RunTime> section.
3. Save MIRSetup.xml.
4. Restart the Metadata Manager Agent.
Working with a Keystore File
You must create the keystore file to configure the Metadata Manager Agent for HTTPS. You can create a
keystore file with keytool. keytool is a utility that generates and stores private or public key pairs and
associated certificates in a file called a “keystore.” When you generate a public or private key pair, keytool
wraps the public key into a self-signed certificate. You can use the self-signed certificate or use a certificate
signed by a certificate authority.
Complete the following tasks to work with the keystore file for the Metadata Manager Agent:
Create a keystore file.
Merge certificates with the Metadata Manager Service keystore file.
Creating a Keystore File
Use keytool in one of the following locations to create a keystore file:
%JAVA_HOME%\jre\bin
java/bin directory of the Informatica installation directory.
For example, to create a keystore file for the Metadata Manager Agent with an alias of mmagent and
keystore name of mmagent.keystore, use the following command:
keytool -genkey -alias mmagent -keystore mmagent.keystore
For more information about using keytool, see the documentation on the Sun web site:
http://java.sun.com/j2se/1.3/docs/tooldocs/win32/keytool.html
Merging Certificates
If you do not use the Metadata Manager Service keystore file when you install the Metadata Manager Agent,
you must merge the certificate in the Metadata Manager Agent keystore to the Metadata Manager Service
keystore.
To merge the certificate, complete the following steps:
1. Export the certificate from the Metadata Manager Agent keystore file.
For example, to export a certificate from a Metadata Manager Agent keystore with an alias of mmagent
and keystore name of mmagent.keystore, issue the following command:
keytool -export -alias mmagent -keystore mmagent.keystore -file mmagent.cer
2. Import the certificate into the Metadata Manager Service keystore file.
26 Chapter 2: Configuring Metadata Manager
For example, to import a certificate to a Metadata Manager Service keystore with an alias of mmservice
and keystore name of mmservice.keystore, issue the following command:
keytool -import -trustcacerts -keystore mmservice.keystore -file mmagent.cer
Step 2. Install the Metadata Manager Agent 27
CHAPTER 3
Application Resources
This chapter includes the following topics:
SAP R/3 Resource Overview, 28
Configuring SAP R/3, 28
Creating an SAP R/3 Resource, 29
Configuring the Component Inclusion List, 31
Reference, 31
SAP R/3 Resource Overview
SAP R/3 is an application platform that integrates multiple business applications and solutions. You can
create and configure an SAP R/3 resource to extract metadata from SAP R/3.
Configuring SAP R/3
Before you create an SAP R/3 resource, you must configure the metadata source. If you do not correctly
configure the metadata source, the metadata load can fail or the metadata can be incorrectly loaded in the
Metadata Manager warehouse.
To configure SAP R/3, complete the following tasks:
Install PowerCenter transports.
Configure a user authorization profile.
Install SAP SDK libraries.
Install Transports
To extract metadata from SAP R/3, you must install the PowerCenter transports that Metadata Manager uses
to extract metadata from SAP R/3. The transports are located in the following folder in the location where you
downloaded PowerCenter:
<download location>\saptrans\mySAP
For more information about installing the transports, see the PowerExchange for SAP NetWeaver Transport
Versions Installation Notice.
28
Configure a User Authorization Profile
The SAP R/3 administrator needs to create the product and development user authorization profile.
The following table describes the user authorization profile:
Authorization
Object
Description Class Field Values
S_RFC Authorization check for
RFC access.
Cross Application
Authorization objects
Activity: 16 (Execute)
Name of RFC to be protected: *.
Type of RFC object to be protected: FUGR
Install the SAP JCo Libraries
Before you create an SAP R/3 resource, download and install SAP JCo 3 for the operating system where the
Metadata Manager Service runs. The SAP JCo installation package includes a library file and a JAR file.
Copy the files to the appropriate directories on the machine where the Metadata Manager Service runs.
If you have problems downloading the files, contact Informatica Global Customer Support.
1. Go to the SAP Service Marketplace: http://service.sap.com
Note: You must have user ID for the SAP Service Marketplace.
2. Download the SAP JCo installation package for the operating system where the Metadata Manager
Service runs.
The installation package contains the following files:
A library file, either sapjco3.dll for Windows or libsapjco3.dll for UNIX
A JAR file, sapjco3.jar
3. Copy the library file to the following directory on the machine where the Metadata Manager Service runs:
<Informatica Installation Directory>\server\bin
4. Copy the JAR file to the following directory on the machine where the Metadata Manager Service runs:
<Informatica Installation Directory>\services\shared\jars\thirdparty
5. Set the following permissions for the library file and the JAR file:
Read, write, and execute permissions for the current user
Read and execute permissions for all other users
Creating an SAP R/3 Resource
Before you create an SAP R/3 resource, configure the SAP R/3 source.
1. On the Load tab, click Actions > New Resource.
The Resource Selection window appears.
2. Click Application > SAP.
3. Click Next.
The Properties page appears.
Creating an SAP R/3 Resource 29
4. Enter the following information:
Property Description
Name Name for the resource. The resource appears in the Resources panel with this name. The name
must be unique and have from one through 256 characters. It cannot include the following characters:
/ \ : * ' ? " < > | [ ]
Description Description for the resource. Description cannot exceed 4000 characters.
Hide in Summary
Lineage
Hides the resource in the summary view of data lineage diagrams.
Enable this option to hide the resource and its child objects in the summary view. Disable this option
to display the resource and its child objects in the summary view.
Default is disabled.
5. Click Next.
The Configuration page appears.
6. Enter the configuration properties.
7. Click Test Connection to test the connection to the source system.
If Metadata Manager cannot connect to the source system, an error message appears. Correct any error
and test the connection again.
8. Click Next.
The Parameters page appears.
9. To search for SAP R/3 tables included in SAP Application Components, enter the table name in the
Search for tables field and click Go.
The tables appear in the Available Components list.
10. To add application components, packages, or tables to the Selected Components list, select the object
in the Available Components list and click Add.
When you select a table, Metadata Manager also includes the SAP Application Component and SAP
package in the hierarchy. If you select any application component, package, or table, Metadata Manager
also extracts all child objects of the object.
11. To add all application components, packages, or tables, click Add All.
12. To remove application components, packages, or tables from the Selected Components list, select the
object in the Selected Components list and click Remove.
13. To remove all components, packages, and tables from the Selected Components list, click Remove
All.
14. Click Next.
The Schedules window appears.
15. To add a schedule, select Attach a Schedule and select a schedule in the Schedule list.
If you have not created a schedule, you can assign a schedule to a resource after you create the
resource.
16. Click Finish.
The resource appears in the Resources panel on the Load tab.
30 Chapter 3: Application Resources
SAP R/3 Configuration Properties
Update the configuration properties when you create or edit an SAP R/3 resource.
The following table describes the SAP R/3 configuration properties:
Property Description
User name SAP R/3 source system connection user name.
Password Password for the user name.
Application server host Host name of the machine where the SAP R/3 application is running.
System number SAP R/3 system number.
Client SAP R/3 client number.
Language Language code of the SAP R/3 system.
Encoding Code page for the application connection for SAP R/3.
Configuring the Component Inclusion List
You can configure the Component Inclusion List parameter for an SAP R/3 resource. To edit the parameter,
select the resource in the Resources panel of the Load tab, click Edit Resource, and click the Parameters tab
in the Edit Resource window.
Use the Component Inclusion List to select the SAP R/3 tables to extract. You can browse for tables included
in SAP Application Components, or you can search for tables. To select a table, move the table from the
Available Components list to the Selected Components list.
When you select a table, Metadata Manager also includes the SAP Application Component and SAP package
in the hierarchy. If you select any application component, package, or table, Metadata Manager also extracts
all child objects of the object.
Reference
After you create and load an SAP R/3 resource, you can view and run data lineage on the metadata objects
that Metadata Manager extracted.
Version
Metadata Manager extracts metadata from SAP R/3, but not from SAP NetWeaver BI.
Configuring the Component Inclusion List 31
Objects Extracted
Metadata Manager extracts the following object types from SAP R/3:
Application components
Packages
Tables
Columns
Primary and foreign keys
Data Lineage
You can perform data lineage analysis between SAP R/3 tables and PowerCenter mappings in Metadata
Manager. Metadata Manager does not extract the data lineage information between SAP R/3 variables and
functions.
In addition, if you manually edit an ABAP program for an Application Source Qualifier in a PowerCenter
mapping, data lineage analysis does not include any tables manually included in the Application Source
Qualifier. For example, if you override an ABAP program to include an SAP R/3 table not included as a
source in a PowerCenter mapping, Metadata Manager does not display the lineage between the
PowerCenter mapping and the SAP R/3 table.
SAP R/3 Schema Class
The SAP R/3 model includes a class named SAP Schema. Metadata Manager uses this class to display data
lineage between SAP R/3 and PowerCenter repository objects. It is not displayed in the metadata catalog
when you load an SAP R/3 resource.
32 Chapter 3: Application Resources
CHAPTER 4
Business Glossary Resources
This chapter includes the following topics:
Business Glossary Resources Overview, 33
Application Services Verification, 34
Creating a Business Glossary Resource, 34
Business Glossary Objects Extracted, 36
Business Glossary Objects Not Extracted, 36
Business Glossary Resources Overview
You can create and configure Business Glossary resources to extract metadata from Informatica Analyst
(Analyst tool) business glossaries. Extract metadata from an Analyst tool business glossary so that you can
relate categories and business terms to other metadata objects.
In the Analyst tool, you define business glossaries in the Glossary workspace. The Glossary workspace can
contain multiple business glossaries. Each business glossary contains assets such as business terms,
categories, and policies. Metadata Manager can extract business terms and categories from a business
glossary.
You create one Business Glossary resource for each Analyst tool business glossary from which you want to
extract metadata. You can create multiple Business Glossary resources, however, the business glossaries
must be managed by the same Analyst Service.
When you create a Business Glossary resource, you specify the following information:
Analyst tool connection information
Name of the business glossary from which you want to extract metadata
Optional enumerated links files that contain linking information for business terms
Optional schedule that specifies the time and frequency of the resource loads
You can use enumerated links files to associate individual business terms with metadata objects in other
resources. For example, you might want to link different business terms with different columns in an Oracle
table. Enumerated links files are CSV files that contain individual pairs of objects that you want to link. You
can upload one or more enumerated links files when you create or edit a Business Glossary resource. For
more information about enumerated links, see the Metadata Manager Custom Metadata Integration Guide.
You can use a schedule to periodically load business glossary resources. Analyst tool users update business
glossary content in the Analyst tool. To ensure that Metadata Manager users always have access to the most
recent business glossary content, schedule regular resource loads.
33
Application Services Verification
Before you create a Business Glossary resource, check the status of the Analyst Service and the associated
services. If the required services are not available, you might not be able to create the resource, or the
metadata load can fail.
Verify that the following services are available:
Analyst Service
Model Repository Service that is associated with the Analyst Service
Data Integration Service that is associated with the Analyst Service
Creating a Business Glossary Resource
Create a Business Glossary resource to extract metadata from an Analyst tool business glossary.
Before you create a Business Glossary resource, verify that the Analyst Service and the associated services
are available.
1. On the Load tab, click Actions > New Resource.
The Resource Selection window appears.
2. Click Business Glossary > Business Glossary.
3. Click Next.
The Properties page appears.
4. Enter the following information:
Property Description
Name Name for the resource. The resource appears in the Resources panel with this name. The name
must be unique and have from one through 256 characters. It cannot include the following characters:
/ \ : * ' ? " < > | [ ]
Description Description for the resource. Description cannot exceed 4000 characters.
Hide in Summary
Lineage
Hides the resource in the summary view of data lineage diagrams.
Enable this option to hide the resource and its child objects in the summary view. Disable this option
to display the resource and its child objects in the summary view.
Default is disabled.
Note: The business glossary resource name should match the Analyst tool glossary name. If the names
do not match, the related terms for a business term do not appear in the Metadata Manager business
glossary.
5. Click Next.
The Configuration page appears.
6. Enter the connection properties.
7. Click Test Connection to test the connection to the source system.
34 Chapter 4: Business Glossary Resources
If Metadata Manager cannot connect to the source system, an error message appears. Correct any error
and test the connection again.
8. Click Next.
The Enumerated Links window appears.
9. Optionally, add or upload the files that contain enumerated links information:
Add enumerated links files when you store the files in a directory that the Metadata Manager web
application can access and the files change.
Upload enumerated links files when the files do not change. Metadata Manager uploads the files into
the Metadata Manager repository.
10. Update the file properties for each enumerated links file, if required.
11. Click Next.
The Schedules window appears.
12. To add a schedule, select Attach a Schedule and select a schedule in the Schedule list.
If you have not created a schedule, you can assign a schedule to a resource after you create the
resource.
13. Click Finish.
The resource appears in the Resources panel on the Load tab.
Business Glossary Connection Properties
Update the connection properties when you create or edit a Business Glossary resource.
The following table describes the connection properties:
Property Description
User name Name of the user account used to connect to the Analyst tool.
Password Password for the user account used to connect to the Analyst tool.
Security domain Name of the security domain to which the Analyst tool user belongs.
If the domain uses LDAP authentication or Kerberos authentication, enter the security domain name.
Otherwise, enter
Native
.
Host Fully qualified host name of the machine where the Analyst tool runs.
Port Analyst tool port number.
Business glossary Name of the Analyst tool business glossary from which you want to extract metadata. Each resource can
extract metadata from one business glossary.
Creating a Business Glossary Resource 35
Business Glossary Objects Extracted
Metadata Manager extracts published business terms and categories from an Analyst tool business glossary.
Metadata Manager extracts published business terms even when the categories to which the terms belong
are unpublished. If an unpublished category includes published business terms, Metadata Manager lists the
terms under the glossary to which the terms belong.
Metadata Manager extracts the following attributes for business terms:
Name
Description
Data steward
Owner
Reference table URL
Status
Phase
Usage context
Custom attributes defined in the Analyst tool
Relationships between the business term and other business terms
Relationships between the business term and categories
Metadata Manager extracts the following attributes for categories:
Name
Description
Data steward
Owner
Usage context
Relationships between the category and business terms
Business Glossary Objects Not Extracted
Metadata Manager does not extract policies or unpublished objects from an Analyst tool business glossary.
Additionally, Metadata Manager does not extract custom properties with names that contain special
characters.
Metadata Manager does not extract the following objects:
Unpublished business terms
Unpublished categories
Policies
Business initiatives
Metadata Manager does not extract custom properties with names that contain any of the following special
characters:
~ ' & * ( ) [ ] | \ : ; " ' < > , ? /
36 Chapter 4: Business Glossary Resources
However, Metadata Manager does extract custom properties with names that contain the following
characters:
! @ # $ % ^ _ - + = { } . ´
Business Glossary Objects Not Extracted 37
CHAPTER 5
Business Intelligence Resources
This chapter includes the following topics:
Business Objects, 38
Cognos, 46
Microsoft Analysis and Reporting Services, 52
Microstrategy, 58
Oracle Business Intelligence Enterprise Edition, 64
SAP Business Warehouse, 70
Tableau, 77
Incremental Metadata Load , 81
Adding or Removing Metadata Files for a Resource, 82
Business Objects
Business Objects is a business intelligence tool that includes components for performance management,
planning, reporting, query and analysis, and enterprise information management.
You can create and configure a Business Objects resource to extract metadata from Business Objects.
Metadata Manager extracts metadata objects for Business Objects reports, universes, and repositories.
Configuring Business Objects
Before you create a Business Objects resource, you must configure the metadata source. If you do not
correctly configure the metadata source, the metadata load can fail or the metadata can be incorrectly loaded
in the Metadata Manager warehouse.
To configure Business Objects, complete the following tasks:
Install the Metadata Manager Agent.
Enable the Metadata Manager Agent to interact with the desktop.
Configure permissions.
Export objects to a repository.
Verify that the required Business Objects clients and servers are running.
Exit the Universe Designer.
38
Install the Metadata Manager Agent
The Metadata Manager Agent is a program that Metadata Manager uses to access metadata sources and
extract source metadata. By default, the Metadata Manager Agent runs on the nodes where the Metadata
Manager Service runs.
To extract metadata from Business Objects, you must install the Metadata Manager Agent separately on a
Windows machine. The Metadata Manager Agent and a single version of the Business Objects client must be
on the same machine. If multiple versions of the Business Objects client are on the same machine as the
Metadata Manager Agent, the agent cannot extract the Business Objects metadata.
The Business Objects client must be able to connect to the source repository. If the client is not on the same
machine as the Metadata Manager Service, install the Metadata Manager Agent on the same machine as the
client. Ensure that you run the Metadata Manager Agent as a desktop application and not as a Windows
service. In addition, ensure that you do not install the Metadata Manager Agent on the same machine as the
Business Objects server.
Related Topics:
“Step 2. Install the Metadata Manager Agent” on page 22
Enable the Metadata Manager Agent to Interact with the Desktop
If you run the Metadata Manager Agent as a service, you must enable the Metadata Manager Agent to
interact with the desktop.
You must enable the Metadata Manager Agent to interact with the desktop for the following metadata
sources:
Business Objects
Microstrategy
ERwin 7.x, 8.x, and 9.x
1. From the Windows Start menu, click Administrative Tools > Services.
2. Double-click Metadata Manager Agent.
The Metadata Manager Agent <Version> Properties dialog box appears.
3. Click the Log On tab.
4. Under Local System Account, click Allow service to interact with desktop.
5. Click OK.
Configure Permissions
Remove permissions from any Business Object universe that you want to export. You cannot extract a write-
protected universe. For more information about removing Business Object permissions, see the Business
Objects documentation.
Make sure that the user who logs in to the Business Objects repository belongs to the Universe Designer
Users group and has read access to all the Business Objects metadata. If the Business Objects repository
contains web intelligence reports in the Favorites or Personal folders, the user should also belong to the
Administrators group. You must create a custom security group giving permission to the user to view Web
intelligence reports.
Business Objects 39
Export Objects to a Repository
Export the Business Objects artifacts such as universes, Webi documents, Desktop Intelligence documents,
and Crystal Reports in the Business Objects source repository. Metadata Manager cannot access the
artifacts that are available the Business Objects cache, but not available in the source repository. Before you
load a Business Object resource, export all artifacts to the source repository to ensure that the metadata in
the Metadata Manager warehouse is consistent with the metadata that is available to Business Objects
users.
Use Business Objects Designer to export a universe to the Business Objects source repository. For example,
to begin the export process in Business Objects Designer, click File > Export. You must secure a connection
type to export a universe to a Business Objects source repository.
Use Business Objects to export a document to the Business Objects repository. For example, to begin the
export process in Business Objects, click File > Publish To > Corporate Documents.
Use the Business Objects Central Manager Console to export Crystal Reports to the Business Objects
repository.
Verify Business Objects Clients and Servers
To extract metadata from Crystal reports and Webi reports, you must verify that the required Business
Objects clients and servers are running. If the required clients and servers are not running, the Metadata
Manager Agent cannot extract metadata from Business Objects reports.
The required clients and servers vary based on the Business Objects version:
SAP Business Objects Repository XI R4.x
To extract metadata from Crystal reports, the Crystal Reports client must be installed on the machine
where the Business Objects client runs.
To extract metadata from Webi reports, the Web Application Container Server (WACS) must be running
and RESTful web services must be installed.
SAP Business Objects Repository XI R3.x and previous versions
To extract metadata from Webi reports, a Web Intelligence Processing Server must be running.
Use the Business Objects Central Management Console to verify the status of Business Objects servers. For
more information about Business Objects clients and servers, see the Business Objects documentation.
Exit the Universe Designer
To extract metadata from a locked Business Objects universe, exit the Universe Designer. If you do not exit
the Universe Designer, the universe becomes unlocked during metadata extraction.
For more information about the Business Objects Universe Designer, see the Business Objects
documentation.
Creating a Business Objects Resource
Before you create a Business Objects resource, configure the Business Objects source.
1. On the Load tab, click Actions > New Resource.
The Resource Selection window appears.
2. Click Business Intelligence > Business Objects.
3. Click Next.
40 Chapter 5: Business Intelligence Resources
The Properties page appears.
4. Enter the following information:
Property Description
Name Name for the resource. The resource appears in the Resources panel with this name. The name
must be unique and have from one through 256 characters. It cannot include the following characters:
/ \ : * ' ? " < > | [ ]
Description Description for the resource. Description cannot exceed 4000 characters.
Hide in Summary
Lineage
Hides the resource in the summary view of data lineage diagrams.
Enable this option to hide the resource and its child objects in the summary view. Disable this option
to display the resource and its child objects in the summary view.
Default is disabled.
5. Click Next.
The Configuration page appears.
6. Enter the configuration properties.
7. Click Test Connection to test the connection to the source system and validate the Metadata Manager
Agent URL.
If Metadata Manager cannot connect to the data source or validate the Metadata Manager Agent URL,
an error message appears. Correct any error and test the connection again.
8. Click Next.
The Schedules page appears.
9. To add a schedule, select Attach a Schedule and select a schedule in the Schedule list.
If you have not created a schedule, you can assign a schedule to a resource after you create the
resource.
10. Click Finish.
The resource appears in the Resources panel on the Load tab.
Business Objects Configuration Properties
Update the configuration properties when you create or edit a Business Objects resource.
The following table describes the Business Objects configuration properties:
Property Description
Agent URL Host name and port number of the Metadata Manager Agent. You can use the Metadata Manager Agent
installed on any machine.
Source system
version
Name and version of the resource.
Version Version of the SAP Business Objects repository. Select a version or configure the Metadata Manager
Agent to detect the version.
Default is auto-detect.
Business Objects 41
Property Description
System Name of the Business Objects repository. For Business Objects 11.x and 12.x, specify the name of the
Business Objects Central Management Server. Specify the server name in the following format:
<server name>:<port number>
If the Central Management Server is configured on a cluster, specify the cluster name in the following
format:
<host name>:<port>@<cluster name>
Default port is 6400.
Note: If the version of the Business Objects repository is 14.0.6, do not specify a port number in the
repository name. If you specify the port number, Metadata Manager cannot extract the Web Intelligence
reports.
Authentication
mode
The authentication mode for the user account that logs in to the Business Objects repository.
Specify one of the following values:
-Enterprise. Log in using the Business Objects Enterprise authentication mode.
-LDAP. Log in using LDAP authentication configured to Business Objects.
Default is enterprise.
User name User name to log in to the Business Objects repository.
Password Password of the user account for the Business Objects repository.
Repository
browsing mode
Specifies the objects that are extracted while browsing for objects in the Business Objects repository. You
can specify one of the following values:
-All. The tree of universes, folders, and documents is extracted.
-Universes only. The tree of universes and folders is extracted. Documents are not extracted.
-Connections only. The list of connections is extracted.
Default is all.
Incremental
import
Load changes since the previous resource load or load complete metadata. Specify one of the following
values:
-True. Load recent changes only.
-False. Perform a complete load of the metadata.
Add dependent
objects
Choose the documents that depend on the universe you selected. Specify one of the following values:
-True. Imports the documents that depend on the specified universe.
-False. Ignores the documents that depend on the specified universe.
Note: Dependency information is retrieved from the Business Objects repository metadata cache. If
modified or moved reports are not reflected in the Metadata Manager load, refresh the cache by loading
these reports and refreshing the queries.
Add specific
objects
Specifies additional objects to the universe. Specify one of the following values:
-None. Ignores all objects.
-Universe independent Documents. Imports documents that do not depend on any universe.
Default is none.
Crystal CORBA
port
Specifies the client port number on which the Crystal SDK communicates with the report application
server (RAS).
The RAS server uses the port to send metadata to the local client computer. If you do not specify a port,
the server randomly selects a port for each execution.
Note: Verify that the local Windows firewall is disabled, or enables communication on the port.
42 Chapter 5: Business Intelligence Resources
Property Description
Class
representation
Controls how the tree structure of classes and sub classes are imported.
Metadata Manager Agent imports each class containing objects as a dimension or as a tree of packages.
Specify one of the following values:
-As a flat structure. Creates no packages.
-As a simplified flat structure. Creates a package for each class with a sub class.
-As a full tree structure. Creates a package for each class.
Default is as a flat structure.
Worker threads Number of worker threads that the Metadata Manager Agent uses to extract metadata asynchronously.
Leave blank or enter a positive integer value.
If blank, the Metadata Manager Agent calculates the number of worker threads. It uses the JVM
architecture and the number of available CPU cores on the machine that runs the Metadata Manager
Agent to calculate the number of threads. If you specify value that is not valid, the Metadata Manager
Agent uses one worker thread.
Reduce the number of worker threads if the Metadata Manger Agent generates out of memory errors
when it extracts metadata. You can increase the number of worker threads if the machine that runs the
Metadata Manager Agent has a large amount of available memory, for example, 10 GB or more. However,
if you specify too many worker threads, performance can decrease.
Default is blank.
Auto assign
connections
Metadata Manager configures connection assignments to relational database resource types during the
resource load. If you disable this option, configure connection assignments in the resource properties after
you create the resource.
Repository subset Accesses objects stored in a remote Business Objects repository. Specify the IDs of universes, reports,
and folders. Separate multiple values with a semicolon.
Reference
After you create and load a Business Objects resource, you can view and run data lineage on the metadata
objects that Metadata Manager extracted.
Data Lineage
Data lineage does not display synthetic universe objects for a non-universe data provider, such as metrics,
attributes, or schema tables.
Datatypes
Metadata Manager does not extract the actual datatype of a column or dimension object.
The following table lists the actual datatypes and the datatypes that Metadata Manager uses:
Datatype Representation Actual Datatype
Character char
Date datetime
Business Objects 43
Datatype Representation Actual Datatype
Long Text binary
Number number
Objects Extracted
Metadata Manager extracts the following metadata object types:
Alias
Body
Cell
Char Column
Char Logical Column
Class
Classes Folder
Column
Combined Query
Condition
Context
Crystal Report
Crystal Report Model
Custom Hierarchies Folder
Data Providers
Data Providers DesignPackage
DataAttribute Column
DataAttribute Detail
DataAttribute Dimension
DataAttribute Measure
Date Column
Date Logical Column
Derived Table
Desktop Intelligence Document
DimensionAttribute Dimension
Document Report
EnterpriseFolder
Field
Filter
Folder
Footer
Header
44 Chapter 5: Business Intelligence Resources
Hierarchy
Join
Key
Key Column
Measure
Number Column
Number Logical Column
ObjectPackage
Page
Prompt Stored Procedure Parameter
Query
Rectangle
Report Axis
Report Chart
Report List
Report Matrix
ReportField Cell
ReportTable Table
Schema
Stored Procedure Parameter
String Column
Table
Universe
Universe Query
UniverseFolder
Web Intelligence Document
Web Intelligence Model
Webi Report
Desktop Intelligence Reports
The Business Objects Desktop Intelligence application shows the reports from the personal folder for the
current user. As a result, Metadata Manager extracts Business Objects Desktop Intelligence reports from a
personal user folder only, even if the user is an administrator. Metadata Manager extracts reports from the
personal folder for the user account that you configure for the resource.
In addition, Metadata Manager does not extract Desktop Intelligence reports from the Favorites folder.
Business Objects 45
Cognos
Cognos is a business intelligence tool that includes applications for reporting, dashboards, scorecarding, and
analysis. You can create and configure a Cognos resource to extract schema and reports metadata from
Cognos.
Configuring Cognos
Before you create a Cognos resource, you must configure the metadata source. If you do not correctly
configure the metadata source, the metadata load can fail or the metadata can be incorrectly loaded in the
Metadata Manager warehouse.
To configure Cognos, complete the following tasks:
Get the external dispatcher URI.
Test the connection.
Verify authentication.
Configure permissions.
Configure resources for the Cognos service.
Get the External Dispatcher URI
To extract metadata from Cognos Content Manager, get the external dispatcher URI. The URI is required to
configure the Cognos Content Manager resource in Metadata Manager. The value corresponds to one of the
dispatchers in the Cognos Content Manager installation. Verify the URI in the Cognos Content Manager
configuration\cogstartup.xml file.
The URI is similar to the following URL:
http://localhost:9300/p2pd/servlet/dispatch
The following example shows an excerpt from cogstartup.xml:
<crn:parameter name=”sdk”>
<crn:value xsi:type=”xsd”anyURI”>http://localhost:9300/p2pd/servlet/dispatch</crn:value>
</crn:parameter>
Use the following rules and guidelines for the external dispatcher URI:
You can also find the dispatcher URL under Environment in the Cognos client.
Use the actual machine name or an IP address for the server name, not localhost.
The https:// prefix for the URI indicates SSL is required.
The Cognos server must support chunking and attachments for large volumes of data. To verify this
requirement, contact the Cognos administrator.
If Metadata Manager and Cognos Content Manager are separated by an intermediary server like a load
balancer or proxy, use the host and port number of the intermediary in the external dispatcher URI.
Test the Connection
You can test the connection by accessing the URI in a web browser. If the URI is correct, Cognos displays a
status message with the current state of the server. Before you load a Cognos resource, the current status of
the server must be “running.”
46 Chapter 5: Business Intelligence Resources
Verify Authentication
If the Cognos server is set up for LDAP authentication, use the web-based Cognos client tool to verify the
connection and authentication properties. Use the following URL to test the authentication:
http://localhost:8080/c8/cm_tester.htm
Use the login namespace, user name, and password you configured in Cognos under Security >
Authentication.
Configure Permissions
Before you configure a Cognos resource, configure the permissions for the user account that you use to
connect to Cognos.
The Cognos user account requires Read, Execute, and Traverse permissions on all objects that Metadata
Manager extracts, including folders, reports, queries, analysis, packages, and connections.
You can secure Cognos data sources against multiple namespaces. The namespace used to secure the data
source may not be the primary namespace used to log in to Cognos. When Metadata Manager extracts a
Cognos object that is associated with a data source secured against multiple namespaces, the Cognos user
account must have the required permissions for the primary namespace.
Configure Resources for the Cognos Service
By default, the Cognos service is configured to use minimal memory resources to optimize startup time. To
increase performance, you can change the number of resources that the Cognos service uses by choosing a
configuration template.
If you load a large number of Cognos models and the load fails with a null pointer exception, set the resource
configuration template to the large configuration. For more information, see the Cognos documentation.
Creating a Cognos Resource
Before you create a Cognos resource, configure the Cognos source.
1. On the Load tab, click Actions > New Resource.
The Resource Selection window appears.
2. Click Business Intelligence > Cognos Report.
3. Click Next.
The Properties page appears.
Cognos 47
4. Enter the following information:
Property Description
Name Name for the resource. The resource appears in the Resources panel with this name. The name
must be unique and have from one through 256 characters. It cannot include the following characters:
/ \ : * ' ? " < > | [ ]
Description Description for the resource. Description cannot exceed 4000 characters.
Hide in Summary
Lineage
Hides the resource in the summary view of data lineage diagrams.
Enable this option to hide the resource and its child objects in the summary view. Disable this option
to display the resource and its child objects in the summary view.
Default is disabled.
5. Click Next.
The Configuration page appears.
6. Enter the configuration properties.
7. Click Test Connection to test the connection to the source system and validate the Metadata Manager
Agent URL.
If Metadata Manager cannot connect to the source system or validate the agent URL, an error message
appears. Correct any error and test the connection again.
8. Click Next.
The Schedules page appears.
9. To add a schedule, select Attach a Schedule and select a schedule in the Schedule list.
If you have not created a schedule, you can assign a schedule to a resource after you create the
resource.
10. Click Finish.
The resource appears in the Resources panel on the Load tab.
Cognos Configuration Properties
Update the configuration properties when you create or edit a Cognos resource.
The following table describes the Cognos configuration properties:
Property Description
Agent URL Host name and port number of the Metadata Manager Agent. You can use the Metadata Manager Agent
installed on any machine.
Source system
version
Version of the data source to which you want to connect.
Version Version of the Cognos server to which you want to connect.
Dispatcher URL URL of the Cognos Content Manager external dispatcher URL.
Namespace Namespace that defines a collection of Cognos user accounts from an authentication provider. If you did
not configure authentication for Cognos, do not configure this option.
48 Chapter 5: Business Intelligence Resources
Property Description
User User name to log in to the Cognos repository database. Required if the Cognos repository database has
been set up to require a user name and password. If you did not configure authentication for Cognos, do
not configure this option.
Password Password to log in to the Cognos repository. Required if the Cognos repository database has been set up
to require a user name and password. If you did not configure authentication for Cognos, do not configure
this option.
Content browsing
mode
The objects that can be retrieved from the Cognos repository. You can select one of the following options:
-Packages only. A tree of packages and folders in the Cognos repository is retrieved. Reports are not
retrieved from the repository.
-Connections only. The list of connections in the Cognos repository is retrieved.
-All. A tree of packages, folders, queries, and reports is retrieved.
Default is All.
Add dependent
objects
Add dependent objects to the initial selection of Cognos objects defined in Content. You can specify one
of the following values:
-True. The first level of dependent objects are added. When a report is specified, the source model
associated with the report is also imported. However, any other reports depending on the source model
are not imported.
-False. Dependent objects are not added to the Cognos object.
Incremental import Load changes since the previous resource load or load complete metadata. Specify one of the following
values:
-True. Load recent changes only.
-False. Perform a complete load of the metadata.
Folder
representation
The representation of folders from Cognos Framework Manager in the catalog. You can specify one of the
following values:
-Ignore. The folders are ignored in the catalog.
-Hierarchical. The folders are represented as diagrams and their hierarchy is preserved in the catalog.
-Flat. The folders are represented as diagrams, but their hierarchy is not preserved in the catalog.
Transformer
import
configuration
Optional XML file that describes the mappings between Cognos Content Manager data sources and the
PowerPlay Transformer models.
Worker threads Number of worker threads that the Metadata Manager Agent uses to extract metadata asynchronously.
Leave blank or enter a positive integer value.
If blank, the Metadata Manager Agent calculates the number of worker threads. It uses the JVM
architecture and the number of available CPU cores on the machine that runs the Metadata Manager
Agent to calculate the number of threads. If you specify value that is not valid, the Metadata Manager
Agent uses one worker thread.
Reduce the number of worker threads if the Metadata Manger Agent generates out of memory errors
when it extracts metadata. You can increase the number of worker threads if the machine that runs the
Metadata Manager Agent has a large amount of available memory, for example, 10 GB or more.
However, if you specify too many worker threads, performance can decrease.
Default is blank.
Cognos 49
Property Description
Auto assign
connections
Metadata Manager configures connection assignments to relational database resource types during the
resource load. If you disable this option, you must configure connection assignments in the resource
properties after you create the resource.
Content Path of models or reports to extract from Cognos. To extract models, use the path to the package
containing the model. To extract packages and reports, select the object or enter the complete search
path to the package or report appended with the following characters: //*. Separate multiple values with a
semicolon (;).
Use Cognos to find the search path for packages or reports. In the Cognos Administration Console, select
the package or report and click Set Properties > View the Search Path, ID, and URL.
If the search path contains multiple reports, Metadata Manager extracts the last report. If the search path
contains published versions of a package, Metadata Manager extracts the latest version and any previous
version used as a data source for current reports.
For example, to extract all content, use the following syntax:
/content//*
To extract packages at the root level, use the following syntax:
/content/package[@name='GO Sales and Retailers']//*
To extract packages within a folder, use the following syntax:
/content/folder[@name='Cognos - Folder']/package[@name='GO Sales and
Retailers']//*
To extract a single report, use the following syntax:
/content/folder[@name='Cognos - Folder']/package[@name='GO Sales and
Retailers']/folder[@name='User Reports']/report[@name='Cascading prompt
report']//*
Note: To extract the latest version of a package, select a single package and set the Add dependent
objects parameter to false.
For more information about the search path syntax, see the Cognos documentation.
Transformer Import Configuration File
When you configure a Cognos resource, you can specify a Transformer import configuration file. The
Transformer import configuration file is an XML file that describes the mappings between Cognos Content
Manager data sources and PowerPlay Transformer models. You create the Transformer import configuration
file.
Multiple Content Manager data sources can refer to the same PowerCube generated from a single
Transformer model. Each Model element in the XML file corresponds to a single Transformer model (.mdl or
pyj) file and lists all the Content Manager data sources that refer to the model's PowerCube. Optionally, the
Model element can list the Impromptu Query Definition data sources (<iqd> child elements) that require
specific database type other than the default database type. The Transformer import configuration file can
have multiple Model elements.
The following code shows a sample Transformer import configuration file:
<ImportConfiguration database="Teradata" dbVersion="1.0.0">
<!-- database: specifies default database for Impromptu Query Definition (IQD) SQL
statements-->
<!-- dbVersion format: major version.minor version.release-->
<Model path="some directory\some model.mdl">
<!--Transformer model (.mdl or .pyj) -->
<cmDataSource name="some Cognos datasource name" />
<!-- List IQD data sources for databases other than default -->
<iqd name="Customers" database="Oracle" dbVersion="11.1.0"/>
50 Chapter 5: Business Intelligence Resources
<iqd name="Products" database="Microsoft SQL Server" dbVersion="8.0.0"/>
</Model>
</ImportConfiguration>
Reference
After you create and load a Cognos resource, you can view and run data lineage on the metadata objects
that Metadata Manager extracted.
Objects Extracted
Metadata Manager extracts the following metadata object types:
Alias Feature
Axis
Body
Calculation
Chart
Chart Node
Chart Node Member
Crosstab
Crosstab Columns
Crosstab Node
Crosstab Node Member
Crosstab Rows
Data Source
Data Sources
DataAttribute
Database Query
Dimension
Field
Filter
Folder
Footer
Header
Hierarchy
Level
List
Measure
Measure Dimension
Model
Model Query
Namespace
Cognos 51
Package
Page
Prompt
PromptAnswer
Queries
Query
Query Item
Query Package
Rectangle
Relationship
Report
Table
Text
Variables
Metadata Catalog
Metadata Manager displays objects differently than they appear in the Cognos client.
You may notice the following differences:
Cognos client displays different icons for namespaces and folders. Metadata Manager displays the
Namespace icon for namespaces and folders.
Cognos shows display labels for Querysubjects that are created from dbQueries. Metadata Manager does
not show the display labels. Instead, it shows the technical names such as the table from which the
Querysubject is built.
Certain objects in Cognos may have multiple instances in Metadata Manager. For example, if a
Querysubject formed from a modelQuery has hierarchies and levels in Cognos, Metadata Manager
displays it under the CognosFMDimension and CognosFMHierarchy classes. Since Metadata Manager
models hierarchies as separate types of objects than dimensions, the same Querysubject appears
multiple times in Metadata Manager.
Metadata Manager may not load all hierarchies. For example, certain Querysubjects in Cognos are built
from dbQueries (database table sources) instead of modelQueries, but still contain hierarchies. Metadata
Manager assumes only dimensional objects can be included in hierarchies. Metadata Manager loads
these Querysubjects as objects of CognosFMSchemaTable class, not the CognosFMHierarchy class.
Microsoft Analysis and Reporting Services
You can create and configure a Microsoft Analysis and Reporting Services resource to extract metadata from
the following sources:
Microsoft SQL Server Reporting Services. Metadata Manager extracts reporting metadata from
Reporting Services.
52 Chapter 5: Business Intelligence Resources
Microsoft SQL Server Analysis Services. If Analysis Services is the data source for the Reporting
Services reports, Metadata Manager can extract the analysis schema from Analysis Services. During the
resource load, Metadata Manager links the Reporting Services and Analysis Services sources. You can
view data lineage across the sources.
You can also configure connection assignments from the Microsoft Analysis and Reporting Services resource
to relational database resources to display data lineage across these sources.
Configuring Microsoft Analysis and Reporting Services
Before you create a Microsoft Analysis and Reporting Services resource, you must configure the metadata
source. If you do not correctly configure the metadata source, the metadata load can fail or the metadata can
be incorrectly loaded in the Metadata Manager warehouse.
To configure Microsoft Analysis and Reporting Services, complete the following tasks:
Install the Metadata Manager Agent.
Install Internet Information Services.
Configure permissions.
Install the Metadata Manager Agent
The Metadata Manager Agent is a program that Metadata Manager uses to access metadata sources and
extract source metadata. By default, the Metadata Manager Agent runs on the nodes where the Metadata
Manager Service runs.
To extract metadata from Microsoft Analysis and Reporting Services, you must install the Metadata Manager
Agent separately on a Windows machine. The Metadata Manager Agent and Reporting Services must be on
the same machine. If Reporting Services is not on the same machine as the Metadata Manager Service,
install the Metadata Manager Agent on the same machine as Reporting Services.
Related Topics:
“Step 2. Install the Metadata Manager Agent” on page 22
Install Microsoft Internet Information Services
If you are using Reporting Services version 2005, you must install Microsoft Internet Information Services 5.0
or later on the machine running Reporting Services.
Configure Permissions
Before you configure a Microsoft Analysis and Reporting Services resource, configure the permissions for the
user account that you use to connect to Analysis and Reporting Services.
The Metadata Manager Agent uses Windows authentication to connect to Analysis and Reporting Services.
The Windows user who starts the Metadata Manager Agent must have read permission on the objects that
the Metadata Manager Agent extracts.
Microsoft Analysis and Reporting Services 53
Creating a Microsoft Analysis and Reporting Services Resource
Before you create a Microsoft Analysis and Reporting Services resource, configure the Microsoft Analysis
and Reporting Services sources.
1. On the Load tab, click Actions > New Resource.
The Resource Selection window appears.
2. Click Business Intelligence > Microsoft Analysis and Reporting Services.
3. Click Next.
The Properties page appears.
4. Enter the following information:
Property Description
Name Name for the resource. The resource appears in the Resources panel with this name. The name
must be unique and have from one through 256 characters. It cannot include the following characters:
/ \ : * ' ? " < > | [ ]
Description Description for the resource. Description cannot exceed 4000 characters.
Hide in Summary
Lineage
Hides the resource in the summary view of data lineage diagrams.
Enable this option to hide the resource and its child objects in the summary view. Disable this option
to display the resource and its child objects in the summary view.
Default is disabled.
5. Click Next.
The Configuration page appears.
6. Enter the configuration properties.
7. Click Test Connection to test the connection to the source system and validate the Metadata Manager
Agent URL.
If Metadata Manager cannot connect to the source system or validate the agent URL, an error message
appears. Correct any error and test the connection again.
8. Click Next.
The Schedules window appears.
9. To add a schedule, select Attach a Schedule, and select a schedule in the Schedule list.
If you have not created a schedule, you can assign a schedule to a resource after you create the
resource.
10. Click Finish.
The resource appears in the Resources panel on the Load tab.
54 Chapter 5: Business Intelligence Resources
Microsoft Analysis and Reporting Services Configuration Properties
Update the configuration properties when you create or edit a Microsoft Analysis and Reporting Services
resource.
The following table describes the Microsoft Analysis and Reporting Services configuration properties:
Property Description
Agent URL Host name and port number of the Metadata Manager Agent. The Metadata Manager Agent must be on the
same machine as Reporting Services.
Source system
version
Name and version of the resource. You cannot edit this field.
SQL Server
version
Version of Microsoft SQL Server Reporting Services.
Report server
URL
URL of the Report Server. For a Report Server running in native mode, enter the URL to the Report Server
using the following format:
http://<host_name>:<portnumber>/<web_service_virtual_directory>
For example:
http://cas12307:80/ReportServer
For a Report Server running in the SharePoint integrated mode, enter the URL to the site containing the
deployed reports. Use the following format:
http://<host_name>
Analysis server
instance
Host name or IP address of the machine running Analysis Services if Analysis Services is the data source
for the Reporting Service reports. During the resource load, Metadata Manager extracts the analysis
schema from Analysis Services. If the Analysis Services instance was named during installation, enter the
host name using the following syntax:
<host_name>\<instance_name>
If you do not want to extract from Analysis Services, do not enter a value.
Auto assign
connections
Metadata Manager configures connection assignments to relational database resource types during the
resource load. If you disable this option, you must configure connection assignments in the resource
properties after you create the resource.
Report server
content
Folder path in Reporting Services that contains the reports that you want to extract. Use "
/
" to indicate the
root repository path, or use
/<folder_name>/<folder_name>
to indicate a single folder path.
To indicate multiple folder paths, use a semicolon to separate the paths. For example,
/<folder_name>/
<folder_name>;/<folder_name>
.
To extract all reports in a folder and its subfolders, specify a folder path. To extract all reports that use a
shared data source, specify the data source path.
Microsoft Analysis and Reporting Services 55
Reference
After you create and load a Microsoft Analysis and Reporting Services resource, you can view and run data
lineage on the metadata objects that Metadata Manager extracted.
Objects Extracted from Reporting Services
Metadata Manager extracts the following objects from Reporting Services:
Report server
Report database
Report project
SSRS report
Data source
Cube
Dimension
Dimension attribute
Measure
Data set
Column
Filter
Report
Report attribute
Report parameter
Objects Extracted from Analysis Services
Metadata Manager extracts the following objects from Analysis Services:
Analysis server
Analysis database
Dimension
Dimension attribute
Hierarchy
Level
Level attribute
Database catalog cube
Measure group
Measure
Key performance indicator (KPI)
Calculated measure
Data source view
Table
Column
56 Chapter 5: Business Intelligence Resources
Logical table
Logical column
Join
Metadata Manager does not extract the following objects from Microsoft Analysis Services:
Data mining structure
Cube perspective
Report attribute
Data Lineage
You can view data lineage for the following Reporting Services and Analysis Services object types:
Calculated measure
Column
Condition
Cube
Data set
Dimension
Dimension attribute
Key performance indicator (KPI)
Level
Logical table
Logical column
Measure
Report
SSRS report
Table
View
You can view data lineage between the following objects within Reporting Services:
Data set column to data source measure
Data set column to data source dimension
Filter to data set column
Report attribute to data set column
You can view data lineage between the following objects within Analysis Services:
Dimension to data source view logical table
Dimension attribute to data source view logical column
Measure to data source view logical column
Key performance indicator (KPI) to measure and dimension attribute
Calculated measure to measure and dimension attribute
Logical table to table
Logical column to column
Microsoft Analysis and Reporting Services 57
If Metadata Manager extracts from Reporting Services and Analysis Services, you can run data lineage
across these sources for reports that use an Analysis Services cube as a data source. You can view data
lineage between the following objects in Reporting Services and Analysis Services:
Report data source measure to Analysis Services measure
Report data source dimension to Analysis Services dimension
Report data source dimension attribute to Analysis Services dimension attribute
You can configure connection assignments between a Microsoft Analysis and Reporting Services resource
and a relational database resource. When you create the links between the resources, you can run data
lineage analysis across the sources. You can view data lineage between the following objects in Reporting
Services and a relational database source:
Report data source column to database column
Report data source table to database table
Report data source table to database view
You can view data lineage between the following objects in Analysis Services and a relational database
source:
Analysis Services data source table to database table
Analysis Services data source column to database column
Analysis Services data source view to database view
Analysis Services data source view column to database view column
Microstrategy
Microstrategy is a business intelligence tool that includes performance management, dashboards, analysis,
and reporting capabilities.
You can create and configure a Microstrategy resource to extract metadata from Microstrategy. Metadata
Manager extracts schema and reporting metadata from Microstrategy.
Configuring Microstrategy
Before you create a Microstrategy resource, you must configure the metadata source. If you do not correctly
configure the metadata source, the metadata load can fail or the metadata can be incorrectly loaded in the
Metadata Manager warehouse.
To configure Microstrategy, complete the following tasks:
Install the Metadata Manager Agent.
Enable the Metadata Manager Agent to interact with the desktop.
Configure privileges.
Configure multiple projects (optional).
58 Chapter 5: Business Intelligence Resources
Install the Metadata Manager Agent
The Metadata Manager Agent is a program that Metadata Manager uses to access metadata sources and
extract source metadata. By default, the Metadata Manager Agent runs on the nodes where the Metadata
Manager Service runs.
To extract metadata from Microstrategy, you must install the Metadata Manager Agent separately on a
Windows machine. The Metadata Manager Agent and the Microstrategy client must be on the same machine.
The client must be able to connect to the source repository. If the Microstrategy client is not on the same
machine as the Metadata Manager Service, install the Metadata Manager Agent on the same machine as the
client.
Related Topics:
“Step 2. Install the Metadata Manager Agent” on page 22
Enable the Metadata Manager Agent to Interact with the Desktop
If you run the Metadata Manager Agent as a service, you must enable the Metadata Manager Agent to
interact with the desktop.
You must enable the Metadata Manager Agent to interact with the desktop for the following metadata
sources:
Business Objects
Microstrategy
ERwin 7.x, 8.x, and 9.x
1. From the Windows Start menu, click Administrative Tools > Services.
2. Double-click Metadata Manager Agent.
The Metadata Manager Agent <Version> Properties dialog box appears.
3. Click the Log On tab.
4. Under Local System Account, click Allow service to interact with desktop.
5. Click OK.
Configure Privileges
The Microstrategy project user account for which you provide the user name and password must have the
Bypass All Object Security Access Checks administration privilege. Set this privilege in the Microstrategy
Desktop client tool.
Note: Although Microstrategy allows you to connect to a project source using database or network
authentication, Metadata Manager uses project source authentication.
Creating a Microstrategy Resource
Before you create a Microstrategy resource, configure the Microstrategy source.
1. On the Load tab, click Actions > New Resource.
The Resource Selection window appears.
2. Click Business Intelligence > Microstrategy.
3. Click Next.
The Properties page appears.
Microstrategy 59
4. Enter the following information:
Property Description
Name Name for the resource. The resource appears in the Resources panel with this name. The name
must be unique and have from one through 256 characters. It cannot include the following characters:
/ \ : * ' ? " < > | [ ]
Description Description for the resource. Description cannot exceed 4000 characters.
Hide in Summary
Lineage
Hides the resource in the summary view of data lineage diagrams.
Enable this option to hide the resource and its child objects in the summary view. Disable this option
to display the resource and its child objects in the summary view.
Default is disabled.
5. Click Next.
The Configuration page appears.
6. Enter the configuration properties.
7. Click Test Connection to test the connection to the source system and validate the Metadata Manager
Agent URL.
If Metadata Manager cannot connect to the source system or validate the agent URL, an error message
appears. Correct any error and test the connection again.
8. Click Next.
The Schedules window appears.
9. To add a schedule, select Attach a Schedule and select a schedule in the Schedule list.
If you have not created a schedule, you can assign a schedule to a resource after you create the
resource.
10. Click Finish.
The resource appears in the Resources panel on the Load tab.
Microstrategy Configuration Properties
Update the configuration properties when you create or edit a Microstrategy resource.
The following table describes the Microstrategy configuration properties:
Property Description
Agent URL Host name and port number of the Metadata Manager Agent. You can use the Metadata Manager Agent
installed on any machine.
Source system
version
Version of the data source to which you want to connect.
Some Microstrategy source versions are deprecated and will become obsolete. Use the supported
versions to load metadata from Microstrategy. You can still create, edit, and load resources from the
deprecated versions. However, Informatica cannot help you resolve an issue encountered on a
deprecated version.
Version Version of Microstrategy. Select a version or configure the Metadata Manager Agent to detect the
version.
Default is auto-detect.
60 Chapter 5: Business Intelligence Resources
Property Description
Project source Name of the project source to which you want to connect.
A project source is a connection to a repository that is located on a local or remote Intelligence Server.
The Intelligence Server connects to a data warehouse and contains a number of metadata projects that
operate on the data warehouse.
Login user The user name to connect to the project source.
Login password The password used to connect to the project source.
Default language The language that you want to use. Microstrategy 9.x supports multiple languages. Select one of the
following values:
-Chinese (Simplified)
-Chinese (Traditional)
-English (United States)
-French (France)
-German (Germany)
-Italian (Italy)
-Japanese
-Korean
-Portuguese (Brazil)
-Spanish (Spain)
-Swedish (Sweden)
Default is English (United States).
Import schema
only
Imports the schemas for the selected projects without the reports and documents. Specify one of the
following values:
-True. Import the schemas only.
-False. Import the schemas, reports, and documents.
Default is false.
Data model tables
design level
The design level of the imported tables. Specify one of the following values:
-Physical. A table appears in the physical view of the model.
-Logical and Physical. A table appears in the logical view and in the physical view of the model.
Incremental import Load changes since the previous resource load or load complete metadata. Specify one of the following
values:
-True. Load recent changes only.
-False. Perform a complete load of the metadata.
Auto assign
connections
Metadata Manager configures connection assignments to relational database resource types during the
resource load. If you disable this option, you must configure connection assignments in the resource
properties after you create the resource.
Projects The name of the projects to which you want connect in the selected project source. Separate multiple
project names with a semicolon (;).
Microstrategy 61
Reference
After you create and load a Microstrategy resource, you can view and run data lineage on the metadata
objects that Metadata Manager extracted.
Objects Extracted
Metadata Manager extracts schema and reporting metadata. In Microstrategy Desktop, you can hide objects,
such as folders, attributes, facts, and logical tables. By default, Metadata Manager extracts hidden objects
stored in Microstrategy.
Metadata Manager extracts the following reporting metadata object types:
Column
Consolidation
Consolidation Element
Custom Group
DesignPackage Folder
Dimension Attribute
Dimension Fact
Dimension Metric
Dimension Sub Total
Dimension Attribute Attribute Form
Filter
Folder Folder
Folder Project
Hidden DesignPackage Folder
Hidden Folder
Hierarchy
Logical Table
Lookup
Measure Fact
Measure Metric
Project Metric
Project Metrics
Prompt
Prompt Answer
Report Document
Report Field2
Report Graph
Report HTML Document
Report Page
Report Page Body
Report Page Footer
62 Chapter 5: Business Intelligence Resources
Report Page Header
Report Rectangle
Report Text
ReportAttribute Attribute Form
ReportDataSet Attribute
Security Filter
StoreContent Document
StoreContent HTML Document
StoreContent Project
StoreContent Report
StoreModel Project
Warehouse Table
Creation and Modification Date of Classes
Metadata Manager displays the source creation date and the source modified date for most Microstrategy
classes. Metadata Manager does not display these dates for the following classes:
MicrostrategyDataType
MicrostrategyReportField
MicrostrategyGraph
MicrostrategySchemaJoin
MicrostrategyGrid
MicrostrategyReportObjectDetail
MicrostrategyReportObject
Metadata Catalog
The metadata catalog does not display attributes and facts the same way Microstrategy does. Microstrategy
contains a classifier object for attributes, but not for facts. Metadata Manager displays a classifier for
Microstrategy facts to remain consistent with the display of attributes.
The following figure shows how Microstrategy and Metadata Manager display attributes and facts:
Microstrategy 63
Expressions
If you define multiple expressions for the same metric or attribute, Metadata Manager may not display the
metric or attribute expression in the metadata catalog.
The following example shows a metric with multiple expressions, where col1 can be found in table T1 and T2:
m = col1
Report Hierarchies
If you include a hierarchy object in a Microstrategy report, Metadata Manager does not load the hierarchy
object.
Oracle Business Intelligence Enterprise Edition
Oracle Business Intelligence Enterprise Edition (OBIEE) is a business intelligence tool that includes analysis
and reporting capabilities.
You can create and configure an OBIEE resource to extract metadata from OBIEE. Metadata Manager
extracts schema and reporting metadata from OBIEE. The schema metadata includes the presentation,
business, and physical models.
Configuring Oracle Business Intelligence Enterprise Edition
Before you create an OBIEE resource, you must configure the metadata source. If you do not correctly
configure the metadata source, the metadata load can fail or the metadata can be incorrectly loaded in the
Metadata Manager warehouse.
To configure OBIEE, complete the following tasks:
Convert the Repository RPD file to an UDML file.
Convert the Repository RPD file to an XML file.
Configure permissions.
Enable OBIEE web services.
Export and import the keystore certificate.
Convert the Repository RPD File to a UDML File
When you load an OBIEE 10g resource, Metadata Manager connects to the Presentation Server to extract
the metadata for the reports. However, Metadata Manager cannot extract the schema metadata directly from
the repository. The OBIEE schema metadata is stored in an RPD file. Because Metadata Manager cannot
read RPD files, you must convert the RPD file to a UDML file.
Metadata Manager extracts the schema metadata from the UDML file, extracts the reports from the
Presentation Server, and links the reporting metadata to the presentation model when you load the resource.
OBIEE has a utility program to convert an RPD file to a UDML file. This utility is part of the OBIEE server
installation.
Use the following command to convert the repository RPD file to a UDML file:
<OBIEE home directory>\server\Bin\nQUDMLGen.exe -U <user name> -P <password> -R <RPD
file>.rpd -O <UDML file>.udml -N -Q -8
64 Chapter 5: Business Intelligence Resources
Convert a Repository RPD File to an XML File
When you load an OBIEE 11g resource, Metadata Manager connects to the Presentation Server to extract
the metadata for the reports. However, Metadata Manager cannot extract the schema metadata directly from
the repository. The OBIEE schema metadata is stored in a RPD file. Because Metadata Manager cannot read
RPD files, you must convert the RPD file to an XML file.
Metadata Manager extracts the schema metadata from the XML file, extracts the reports from the
Presentation Server, and links the reporting metadata to the presentation model when you load the resource.
You can use the biserverxmlgen command line utility to convert a RPD file to an XML file. This utility is part of
the OBIEE server installation. Before you run the utility, you must run the run bi-init script to launch the
prompt window that is initialized to the Oracle instance. The script file is available in the following location:
ORACLE_INSTANCE/bifoundation/OracleBIApplication/coreapplication/setup
.
Use the following command to convert the repository RPD file to an XML file:
biserverxmlgen -R repository_pathname [-P password] -O output_file_pathname -n - Q -8
where,
repository_pathname is the name and location of the repository file from which you want to generate XML.
password is the repository password.
output_file_pathname is the name and location of the XML output file you want to generate.
Specify -8 to use UTF-8 encoding in the generated XML file. By default, the generated XML file uses ANSI
ISO-8859-1 encoding.
Configure Permissions
Metadata Manager connects to the OBIEE Presentation Server to extract the report metadata. The OBIEE
user account for which you provide the user name and password must have read permission on the metadata
that Metadata Manager extracts from OBIEE. The metadata includes subject areas, report folders, and
reports.
Metadata Manager extracts the schema metadata from the UDML or XML file. The OBIEE user account does
not require permissions on the schema metadata. The OBIEE utility program extracts all schema metadata
from the RPD file and writes the metadata to the UDML or XML file. Metadata Manager extracts all metadata
from the UDML or XML file.
Enable OBIEE Web Services
Metadata Manager uses OBIEE web services to extract metadata from OBIEE. As a result, you must enable
OBIEE web services. OBIEE web services is available to licensed users of OBIEE. The OBIEE installer
generates the appropriate licensing entries in the analyticsweblicense.xml file based on the installation key.
To verify that OBIEE web services are enabled, check that the kmsgLicenseSOAPAccess entry exists in the
following file:
<OBIEE home directory>\web\config\analyticsweblicense.xml
Export and Import the Keystore Certificate
Before you extract metadata from an OBIEE Presentation Server in HTTPS mode, you must export the
keystore certificate from OBIEE and import it into the Metadata Manager Agent Java Runtime Environment
(JRE). When you export the certificate, you create a self-signed certificate that you can import into the
Metadata Manager Agent JRE.
Use the keytool utility to export and import the certificate.
Oracle Business Intelligence Enterprise Edition 65
To export and import the certificate:
1. To export the OBIEE keystore certificate and create a self-signed keystore certificate, use the following
command:
keytool -export -alias <alias name> -keystore <keystore file name> -rfc -file
<certificate file name>
2. Copy the certificate file to the following directory:
<Metadata Manager Agent installation directory>\java\jre\lib\security
3. Navigate to the following directory:
<Metadata Manager Agent installation directory>\java\jre\lib\security
4. To import the OBIEE keystore certificate into the Metadata Manager Agent JRE, use the following
command:
keytool -import -alias -ca -file <certificate file name> -keystore <certificate file
name> -storepass <keystore password>
Note: The default keystore password is “changeit.”
Creating an Oracle Business Intelligence Enterprise Edition
Resource
Before you create an OBIEE resource, configure the OBIEE source.
1. On the Load tab, click Actions > New Resource.
The Resource Selection window appears.
2. Click Business Intelligence > Oracle Business Intelligence.
3. Click Next.
The Properties page appears.
4. Enter the following information:
Property Description
Name Name for the resource. The resource appears in the Resources panel with this name. The name
must be unique and have from one through 256 characters. It cannot include the following characters:
/ \ : * ' ? " < > | [ ]
Description Description for the resource. Description cannot exceed 4000 characters.
Hide in Summary
Lineage
Hides the resource in the summary view of data lineage diagrams.
Enable this option to hide the resource and its child objects in the summary view. Disable this option
to display the resource and its child objects in the summary view.
Default is disabled.
5. Click Next.
The Configuration page appears.
6. Enter the configuration properties.
7. To add a metadata source file, click Select.
If you configure Metadata Manager to use the latest source files, include the absolute path to the files
that are accessible from the Metadata Manager Agent machine.
If you did not configure Metadata Manager to use the latest source files, upload all the files to the
Metadata Manager machine.
66 Chapter 5: Business Intelligence Resources
8. Click Test Connection to validate the source file configuration.
Metadata Manager validates the Metadata Manager Agent URL. If you configured Metadata Manager to
use the latest source file, Metadata Manager also validates that the source file exists in the specified
path. If the source file is uploaded to Metadata Manager, Metadata Manager validates that the file is
compatible with the resource type and version.
If Metadata Manager cannot validate the source file configuration, an error message appears. Correct
any error and test the connection again.
9. Click Next.
The Schedules window appears.
10. To add a schedule, select Attach a Schedule, and select a schedule in the Schedule list.
If you have not created a schedule, you can assign a schedule to a resource after you create the
resource.
11. Click Finish.
The resource appears in the Resources panel on the Load tab.
Oracle Business Intelligence Enterprise Edition Configuration Properties
Update the configuration properties when you create or edit an OBIEE resource.
The following table describes the OBIEE configuration properties:
Property Description
Agent URL Host name and port number of the Metadata Manager Agent. You can use the Metadata Manager Agent
installed on any machine.
Source system
version
Name of the metadata source. You cannot edit this field.
Always use latest
source files
Uses the metadata source file in the location you provide each time you load the resource. If you enable
this option, the path to the file must include an absolute path that is accessible from the Metadata Manager
Agent machine. If you disable this option, Metadata Manager copies the metadata source file to the
Metadata Manager application directory when you finish configuring the resource. Each time you load the
resource, Metadata Manager uses the copied metadata source file in the Metadata Manager application
directory.
Version Version of OBIEE. Select a version or configure Metadata Manager to detect the version.
Default is auto detect.
Server URL URL of the Presentation Server. Use the following format:
http://<server name>:<port>/analytics/saw.dll
Login user User name for the Presentation Server.
Note: Verify that the user has the appropriate permissions to access the objects you want to import.
Login password Password for the Presentation Server user name.
Variable values
file
Path to the file that contains the variable values used in a repository RPD file.
A repository RPD file might use variables to parameterize SQL statements. The variables values file
contains the variable name and values used in the repository file.
Variable names are not case sensitive and are trimmed of all leading and trailing spaces.
Oracle Business Intelligence Enterprise Edition 67
Property Description
Optimize for
large models
Specifies whether to import a subset of metadata or all metadata when you load the resource. You might
want to import a subset of metadata when the metadata source file is large, for example, when the file size
exceeds 600 MB.
Specify one of the following values:
-True. Ignores foreign keys, joins, relationships, and logical foreign keys when you load the resource.
Does not store expression tree objects with lineage links.
-False. Imports all metadata when you load the resource.
Default is true.
Incremental
import
Load changes since the previous resource load or load complete metadata. Specify one of the following
values:
-True. Load recent changes only.
-False. Perform a complete load of the metadata.
Worker threads Number of worker threads that the Metadata Manager Agent uses to extract metadata asynchronously.
Leave blank or enter a positive integer value.
If blank, the Metadata Manager Agent calculates the number of worker threads. It uses the JVM
architecture and the number of available CPU cores on the machine that runs the Metadata Manager Agent
to calculate the number of threads. If you specify value that is not valid, the Metadata Manager Agent uses
one worker thread.
Reduce the number of worker threads if the Metadata Manger Agent generates out of memory errors when
it extracts metadata. You can increase the number of worker threads if the machine that runs the Metadata
Manager Agent has a large amount of available memory, for example, 10 GB or more. However, if you
specify too many worker threads, performance can decrease.
Default is blank.
Auto assign
connections
Metadata Manager configures connection assignments to relational database resource types during the
resource load. If you disable this option, you must configure connection assignments in the resource
properties after you create the resource.
File The OBIEE repository file in XML or UDML format.
You export the repository from the Oracle BI Administration tool to an RPD file. For OBIEE 10g resources,
convert the RPD file as an UDML file. For OBIEE 11g resource, convert the RPD file as an XML file.
Repository
subset
Folder path in the Presentation Server that contains the reports that you want to extract. Separate multiple
values with a semicolon (;).
Use "
/
" to indicate the root repository path, use
/shared
to indicate the shared repository path, or use
/
users/<user_name>/<folder_name>
to indicate the user's folder path.
For example:
/shared/Financials;/shared/Human Resources;/shared/Procurement
and Spend
Default is “
/
”.
Reference
After you create and load an OBIEE resource, you can view and run data lineage on the metadata objects
that Metadata Manager extracted.
Objects Extracted
Metadata Manager extracts the following metadata object types:
Alias Column
68 Chapter 5: Business Intelligence Resources
AliasPhysicalTable
AnswersReport
Axis
BusinessModel
Business Model and Mapping
Catalog
Condition
Criteria
Data Attribute Column
Database
Derived Presentation Column
Design Package Subject Area
Dimension Logical Column
DynamicVariable
FactLogicalTable
Field
Folder
Gauge
Graphic Chart
Hierarchy
Key Logical Column
LogicalColumn
LogicalDimension
LogicalJoin
LogicalKeyColumn
LogicalLevel
LogicalTable
Measure
Model Content
Page
Physical
PhysicalColumn
PhysicalForeignKey
PhysicalJoin
PhysicalSelectTable
PhysicalTable
PivotTable
Presentation
PresentationColumn
Oracle Business Intelligence Enterprise Edition 69
PresentationTable
Primary Key Column
Report
RepositoryInitializationBlock
RepositoryInitializationBlocks
RepositoryVariables
Schema
SessionInitBlock
Session Initialization Blocks
SessionVariable
SessionVariables
StaticVariable
StaticVariables
TableView
TitleView
Top View
Variables
View
Alias Physical Table
An alias physical table is a synonym object of a physical table. When Metadata Manager loads an OBIEE
resource, it extracts physical table columns and copies them to the corresponding alias physical table.
Metadata Manager sets the class type for a copied column as a physical column, even if the original column
is a key column or a normal column.
Number of Child Nodes in the Load Details
When you load an OBIEE resource, Metadata Manager displays the nodes from which it extracts metadata
on the Load Details tab. Metadata Manager displays 300 child nodes for any parent node in the load details.
To see a complete list of all nodes extracted, save the contents of the Load Details tab to a Microsoft Excel
file.
SAP Business Warehouse
SAP Business Warehouse is a enterprise data warehouse platform that captures, stores, and consolidates
enterprise data.
You can create and configure an SAP Business Warehouse resource to extract metadata from SAP Business
Warehouse.
70 Chapter 5: Business Intelligence Resources
Configuring SAP Business Warehouse
Before you create an SAP Business Warehouse resource, you must configure the metadata source. If you do
not correctly configure the metadata source, the metadata load can fail or the metadata can be incorrectly
loaded in the Metadata Manager warehouse.
To configure SAP Business Warehouse, complete the following tasks:
Install the Metadata Manager Agent.
Configure the mapping transformation file.
Install the SAP JCo libraries.
Install the Metadata Manager Agent
The Metadata Manager Agent is a program that Metadata Manager uses to access metadata sources and
extract source metadata. By default, the Metadata Manager Agent runs on the nodes where the Metadata
Manager Service runs.
To extract metadata from SAP Business Warehouse, you must install the Metadata Manager Agent
separately on a Windows machine. The Metadata Manager Agent and the SAP JCo libraries must be on the
same machine.
Related Topics:
“Step 2. Install the Metadata Manager Agent” on page 22
Configure the Mapping Transformation File
SAP Business Warehouse transformations are sometimes represented in ABAP code. Save these
transformations in a mapping configuration file.
Use the following format to specify the transformations in the mapping, and save the file as an XML file:
<Functions>
<Function id="[TransformationId]" objType="TRFN">
<Target id="RESULT_FIELDS-[dstFieldName]" description="RESULT_FIELDS-[dstFieldName]
= SOURCE_FIELDS-[srcFieldName] * [externalObjectId]-[externalField].">
<Source id="SOURCE_FIELDS-[srcFieldName]"/>
<Source id="[externalObjectId]-[externalField]"/>
</Target>
</Function>
</Functions>
When you configure the SAP Business Objects resource, you must specify the file name and file path for the
mapping transformation file.
Install the SAP JCo Libraries
Before you create an SAP Business Warehouse resource, download and install SAP JCo 3 for Windows. The
SAP JCo installation package includes a library file and a JAR file. Copy the files to a directory on the
machine that runs the Metadata Manager Agent.
If you have problems downloading the files, contact Informatica Global Customer Support.
1. Stop the Metadata Manager Agent.
2. Go to the SAP Service Marketplace: http://service.sap.com
Note: You must have user ID for the SAP Service Marketplace.
3. Download the SAP JCo installation package for Windows.
SAP Business Warehouse 71
The installation package contains the following files:
A library file, sapjco3.dll
A JAR file, sapjco3.jar
4. Copy the library file and the JAR file to the following directory or to a different directory on the machine
that runs the Metadata Manager Agent:
<Metadata Manager Agent home directory>\bin
5. If you copy the files to a directory other than
<Metadata Manager Agent home directory>\bin
, update
the classpath on the machine that runs the Metadata Manager Agent. The classpath must include the
directory where you copied the files.
6. Set the following permissions for the library file and the JAR file:
Read, write, and execute permissions for the current user
Read and execute permissions for all other users
7. Restart the Metadata Manager Agent.
Creating an SAP Business Warehouse Resource
Before you create an SAP Business Warehouse resource, configure the SAP Business Warehouse source.
1. On the Load tab, click Actions > New Resource.
The Resource Selection window appears.
2. Click Business Intelligence > SAP Business Warehouse.
3. Click Next.
The Properties page appears.
4. Enter the following information:
Property Description
Name Name for the resource. The resource appears in the Resources panel with this name. The name
must be unique and have from one through 256 characters. It cannot include the following characters:
/ \ : * ' ? " < > | [ ]
Description Description for the resource. Description cannot exceed 4000 characters.
Hide in Summary
Lineage
Hides the resource in the summary view of data lineage diagrams.
Enable this option to hide the resource and its child objects in the summary view. Disable this option
to display the resource and its child objects in the summary view.
Default is disabled.
5. Click Next.
The Configuration page appears.
6. Enter the configuration properties.
7. Click Test Connection to test the connection to the source system and validate the Metadata Manager
Agent URL.
If Metadata Manager cannot connect to the source system or validate the agent URL, an error message
appears. Correct any error and test the connection again.
8. Click Next.
72 Chapter 5: Business Intelligence Resources
The Schedules window appears.
9. To add a schedule, select Attach a Schedule and select a schedule in the Schedule list.
If you have not created a schedule, you can assign a schedule to a resource after you create the
resource.
10. Click Finish.
The resource appears in the Resources panel on the Load tab.
SAP Business Warehouse Configuration Properties
Update the configuration properties when you create or edit an SAP Business Warehouse resource.
The following table describes the SAP Business Warehouse configuration properties:
Property Description
Agent URL Host name and port number of the Metadata Manager Agent. You can use the Metadata Manager Agent
installed on any machine.
Source system
version
Version of the data source to which you want to connect.
Application server Host name or IP address of the SAP application server to which you want to connect.
Router string Router string to use when the system is protected by a firewall.
System number SAP system number, which is the instance ID of the ABAP instance. This value is a 2-digit number from
00 through 99.
Client SAP system client ID. This value is a 3-digit number from 000 through 999.
User name The user name to connect to SAP Business Warehouse.
Password The password for the SAP Business Warehouse user.
Default language The language that you want to use. Select one of the following values:
-Chinese (Simplified)
-Chinese (Traditional)
-Czech
-Danish
-Dutch
-English
-Finnish
-French
-German
-Hungarian
-Italian
-Japanese
-Korean
-Norwegian
-Polish
-Portuguese
-Russian
-Spanish
-Slovak
-Swedish
-Turkish
SAP Business Warehouse 73
Property Description
JCo library path Location of the SAP JCo library file and sapjco3.jar file on the machine that runs the Metadata Manager
Agent.
The files must be in the following directory or in a directory that is in the classpath of the machine that
runs the Metadata Manager Agent:
<Metadata Manager Agent home directory>\bin
Mapping
configuration file
File name and file path for the mapping configuration file. The mapping configuration file contains the
SAP Business Warehouse transformations that are represented in ABAP code.
Naming convention The format used to represent the SAP system number. Specify one of the following values:
-[technical name]Description
-Description[Technical Name]
-Description_TechnicalName
-[TechnicalName]
Incremental import Load changes since the previous resource load or load complete metadata. Specify one of the following
values:
-True. Load recent changes only.
-False. Perform a complete load of the metadata.
Path to offline
metadata
Directory that contains metadata when the SAP Business Warehouse metadata environment is not
installed locally. If you specify an offline metadata directory, the Metadata Manager Agent uses the files
in the directory as the metadata source. Metadata Manager ignores the connection properties for the
SAP application server because it does not need to establish a connection to the server.
You can run a utility to generate a directory of files that contain the metadata from the SAP Business
Warehouse environment. You might copy metadata from the SAP Business Warehouse environment to a
directory for testing purposes.
Default is not set.
Auto assign
connections
Metadata Manager configures connection assignments to relational database resource types during the
resource load. If you disable this option, you must configure connection assignments in the resource
properties after you create the resource.
Reference
After you create and load an SAP Business Warehouse resource, you can view and run data lineage on the
metadata objects that Metadata Manager extracted.
Objects Extracted
Metadata Manager extracts the following metadata object types:
Application
Attribute Field
BEx Web Template
Bex Web Template StoreModel
Bex Web Templates
Characteristic
Class Data Source
Class Data Source3x
74 Chapter 5: Business Intelligence Resources
Condition
Data Packet Characteristic
DataMappingModel Transfer Rules
DataMappingModel Transformations
DataProvider
DataSource Application
DataSource3x
DiDataMappingContent Transfer Rules
DiDataMappingContent Transformations
DiDataMappingContent Update Rules
Dimension
Dimension Aggregate
Dimension DataStore Object
Dimension InfoCube
Dimension InfoSet
Dimension InfoSource
Dimension InfoSource3x
Dimension Open Hub Destination
Dimension Query
Dimension QueryView
DimensionAttribute Characteristic
Excel Workbook
Folder InfoObjects
Folder InfoSources
Folder Transfer Rules
Folder Transformations
InfoArea
InfoObject
InfoObject Catalog
Key Figure
MultiProvider
Navigation Attribute
Queries
QueryView
QueryViews
Role
Source System
StoreContent Aggregate
StoreContent Bex Web Template
SAP Business Warehouse 75
StoreContent Characteristic
StoreContent DataSource
StoreContent DataSource3x
StoreContent DataStore Object
StoreContent InfoCube
StoreContent InfoSet
StoreContent InfoSource
StoreContent InfoSource3x
StoreContent MultiProvider
StoreContent Open Hub Destination
StoreContent Query
StoreContent QueryView
StoreContent Web Template
StoreContent Workbook
StoreModel Aggregate
StoreModel Characteristic
StoreModel DataSource
StoreModel DataStore Object
StoreModel InfoCube
StoreModel InfoSet
StoreModel InfoSource
StoreModel InfoSource3x
StoreModel MultiProvider
StoreModel Open Hub Destination
StoreModel Query
Time Characteristic
Time Dimension
Unit of Measurement
Update Rules
Web Template
Web Template (Format SAP BW 3.x)
Web Templates
Workbook
Workbooks
76 Chapter 5: Business Intelligence Resources
Tableau
Tableau is a business intelligence tool that allows you to connect to data and create sharable dashboards.
Tableau has a desktop component and a server component. Metadata Manager can extract metadata from
the server component of Tableau, Tableau Server.
Metadata Manager extracts metadata from Tableau Server through the Metadata Manager Agent. The
Metadata Manager Agent uses the HTTP or HTTPS protocol to log in to the server, send requests about
workbooks and data sources, and extract metadata. The Metadata Manager Agent can extract objects such
as projects, workbooks, and dashboards from Tableau. The Metadata Manager Agent extracts both published
and unpublished worksheets in workbooks. The Metadata Manager Agent also extracts dependent data
sources for workbooks.
Data sources in Tableau represent connections to data. The data can be located as a Tableau extract (.tde
file) or in a live relational database. The Metadata Manager Agent imports both Tableau extracts and live
data sources into Metadata Manager.
Configuring Tableau
Before you create a Tableau resource, you must configure the metadata source. If you do not correctly
configure the metadata source, the metadata load can fail or the metadata can be incorrectly loaded in the
Metadata Manager warehouse.
To configure Tableau, perform the following tasks:
Install the Metadata Manager Agent.
Verify permissions.
Verify that Tableau Server is running.
Install the Metadata Manager Agent
The Metadata Manager Agent is a program that Metadata Manager uses to access metadata sources and
extract source metadata. By default, the Metadata Manager Agent runs on the nodes where the Metadata
Manager Service runs. To extract metadata from Tableau, you can use the Metadata Manager Agent that is
installed on any Windows machine.
You must install the Metadata Manager Agent separately on a Windows machine when the domain uses
Kerberos authentication or when the Metadata Manager Service runs on UNIX.
Related Topics:
“Step 2. Install the Metadata Manager Agent” on page 22
Verify Permissions
To connect to Tableau Server, the Metadata Manager Agent uses the credentials of a user created on the
Tableau server. The user account must have certain license levels and permissions.
The account that the Metadata Manager Agent uses to access Tableau Server must have at least the
following license levels and permissions:
Interactor license level
View and Download permissions for all projects, workbooks, and data sources for which you want to
extract metadata
Tableau 77
Verify that the Server is Running
The Metadata Manager Agent connects to Tableau Server through the internet. To verify that Tableau Server
is running, ensure that you can connect to Tableau Server from a web browser.
Creating a Tableau Resource
Before you create a Tableau resource, configure the Tableau metadata source.
1. On the Load tab, click Actions > New Resource.
The Resource Selection window appears.
2. Click Business Intelligence > Tableau.
3. Click Next.
The Properties page appears.
4. Enter the following information:
Property Description
Name Name for the resource. The resource appears in the Resources panel with this name. The name
must be unique and have from one through 256 characters. It cannot include the following characters:
/ \ : * ' ? " < > | [ ]
Description Description for the resource. Description cannot exceed 4000 characters.
Hide in Summary
Lineage
Hides the resource in the summary view of data lineage diagrams.
Enable this option to hide the resource and its child objects in the summary view. Disable this option
to display the resource and its child objects in the summary view.
Default is disabled.
5. Click Next.
The Configuration page appears.
6. Enter the configuration properties.
7. Click Test Connection to test the connection to the source system and validate the Metadata Manager
Agent URL.
If Metadata Manager cannot connect to the data source or validate the Metadata Manager Agent URL,
an error message appears. Correct any error and test the connection again.
8. Click Next.
The Schedules page appears.
9. To add a schedule, select Attach a Schedule and select a schedule in the Schedule list.
If you have not created a schedule, you can assign a schedule to a resource after you create the
resource.
10. Click Finish.
The resource appears in the Resources panel on the Load tab.
78 Chapter 5: Business Intelligence Resources
Tableau Configuration Properties
Update the configuration properties when you create or edit a Tableau resource.
The following table describes the Tableau configuration properties:
Property Description
Agent URL Host name and port number of the Metadata Manager Agent. You can use the Metadata Manager Agent
installed on any machine.
Source system
version
Name and version of the resource. You cannot edit this field.
Server URL or IP address where Tableau Server runs. For example:
http://<Tableau host>:<port>
Default is http://localhost:80.
Site Site name when you extract metadata from a multi-site server. The site name is case sensitive.
User name User name used to log in to Tableau Server.
Password Password for the Tableau Server user account.
Group by Category used to group the workbooks that you want to extract from Tableau. When you click Select next
to the Repository Objects property, the Metadata Manager Agent groups workbooks in the dialog box by
the category that you select.
You can group workbooks by the following categories:
-Tags
-Publisher
-Project
-My workbooks
-All workbooks
Default is project.
Incremental
import
Load changes since the previous resource load or load complete metadata.
Specify one of the following values:
-True. Load recent changes only.
-False. Perform a complete load of the metadata.
Default is true.
Worker threads Number of worker threads that the Metadata Manager Agent uses to extract metadata asynchronously.
Leave blank or enter a positive integer value.
If blank, the Metadata Manager Agent calculates the number of worker threads. It uses the JVM
architecture and the number of available CPU cores on the machine that runs the Metadata Manager Agent
to calculate the number of threads. If you specify value that is not valid, the Metadata Manager Agent uses
one worker thread.
Reduce the number of worker threads if the Metadata Manger Agent generates out of memory errors when
it extracts metadata. You can increase the number of worker threads if the machine that runs the Metadata
Manager Agent has a large amount of available memory, for example, 10 GB or more. However, if you
specify too many worker threads, performance can decrease.
Default is blank.
Tableau 79
Property Description
Auto assign
connections
Metadata Manager configures connection assignments to relational database resource types during the
resource load. If you disable this option, configure connection assignments in the resource properties after
you create the resource.
Repository
objects
The workbooks that you want to extract from Tableau. Click Select to select individual workbooks or
groups of workbooks. In the selection dialog box, Metadata Manager groups workbooks according to the
category you choose in the Group by property.
When you select one or more workbooks, this field displays the Tableau workbook ID for each selected
workbook.
The Metadata Manager Agent extracts the dependent data sources for all selected workbooks.
Reference
After you create and load a Tableau resource, you can view and run data lineage on the metadata objects
that Metadata Manager extracted.
Objects Extracted
Metadata Manager extracts the following metadata object types:
Bins
Calculation dimensions
Calculation measures
Columns
Conditions
Connections
Dashboards
Data sources
Dimensions
Dimension tables
Fact tables
Fields
Filters
Groups
Joins
Marks
Measures
Namespaces
Pages
Parameter dimensions
Parameter measures
Parameters
Projects
80 Chapter 5: Business Intelligence Resources
Proxy fields
Proxy tables
Published data sources
Queries
Relationships
Rows
Schemas
Sets
Shared filters
Tables
Tableau servers
Unpublished worksheets
Workbook data sources
Workbooks
Worksheets
Data Lineage Restrictions
Metadata Manager makes most Tableau object types available for data lineage. However, there are some
data lineage restrictions on Tableau objects.
The following Tableau objects have data lineage restrictions:
Dashboards
Metadata Manager does not display data lineage for dashboards. However, you can run data lineage
analysis on the worksheets that are included in the dashboard.
Data sources
Data sources in Tableau can be either live data sources or extracts. A live data source represents a
connection to a physical data source such as a relational database. An extract is a snapshot of a data
source that is saved to a .tde file.
When you view a data lineage diagram that includes a live data source, Metadata Manager displays the
physical data source in the data lineage diagram. For example, if you run data lineage analysis on a
Tableau live data source that is based on an Oracle table, Metadata Manager displays the Oracle table
in the data lineage diagram. Metadata Manager displays a link between the Oracle table and the Tableau
live data source.
When you view a data lineage diagram that includes an extract, Metadata Manager displays the extract
as the source for data lineage. Metadata Manager does not display a link between the physical data
source and the extract. Metadata Manager does not display the link because it cannot determine which
physical data source an extract is based on.
Incremental Metadata Load
When you configure any business intelligence resource except a Microsoft Analysis and Reporting Services
resource, you can choose to incrementally load recent changes to the metadata instead of loading complete
Incremental Metadata Load 81
metadata. After the first successful load, the Metadata Manager Agent incrementally loads metadata that
changed after the last successful load.
Data Source Changes
New metadata is incrementally loaded when any data source change occurs after the last successful load.
The following list describes some examples of data source changes:
A report is added in a report folder.
A report is linked to a different package or universe.
A report metric is deleted.
A report is deleted or renamed.
A report is moved to another folder.
A report folder is renamed.
An attribute object in a package or universe is renamed.
A folder is moved to another folder.
Note: If the source data did not change since the last successful load, the load is complete.
Exception Scenarios
Even if you specify incremental extraction for a resource, complete metadata load occurs in the following
scenarios:
You purge the resource.
You update the source configuration details of the resource.
You cancel the first load of the resource or the first load of the resource fails.
Adding or Removing Metadata Files for a Resource
Add a metadata file to a resource to configure the source from which Metadata Manager extracts metadata.
Remove a metadata file from a resource if you want to remove the metadata from the Metadata Manager
warehouse or load a different metadata source file.
You can add one metadata file for each resource. After you remove a metadata file, you can purge the
metadata from the Metadata Manager warehouse.
You can add or remove the following metadata files:
Metadata source files. Add or remove a metadata source file for packaged resource types.
Attribute and association files. Add or remove attribute and association files for a custom resource. You
must also add a metadata source file if the contents of an existing attribute and association file changes.
Note: To change the metadata in the source file that Metadata Manager loads into the Metadata Manager
warehouse, change the contents of the metadata source file and add the file again. You can also upload the
file to the following directory on the node that runs the Metadata Manager Service:
<Informatica installation directory>\services\MetadataManagerService\mm_files\<Metadata
Manager Service name>\mm_load\data_files\<resource ID>
1. On the Load tab, select the resource for which you want to add or remove files.
2. In the Resources panel, click the Configuration tab, and then click Edit.
The Edit Resources window appears.
82 Chapter 5: Business Intelligence Resources
3. To add a metadata source file, click Add and select the file.
If you configured Metadata Manager to use the latest source files, include an absolute path to the file
that is accessible from the Metadata Manager Service machine.
4. Optionally, direct Metadata Manager to update the metadata in the warehouse with the metadata in the
source file.
5. To remove a metadata source file, select the file and click Remove.
6. Click OK.
Adding or Removing Metadata Files for a Resource 83
CHAPTER 6
Custom Resources
This chapter includes the following topics:
Configuring Custom Metadata Sources, 84
Creating a Custom Resource, 84
Configuring the Template Name, 85
Adding or Removing Metadata Files for a Resource, 85
Configuring Custom Metadata Sources
If you create a custom resource and use a metadata source file, you must export the metadata to a metadata
file with a .csv or .txt file extension. When you configure the custom resource, you specify the metadata file.
Creating a Custom Resource
When you create a custom resource, you configure the name and description. You add metadata source files
and schedules after you create the resource.
1. On the Load tab, click Actions > New Resource.
The Resource Selection window appears. The list of custom models you created in the Model page
appears under Others.
2. Under Others, select the custom model you want to base the resource on.
3. Click Next.
The Properties page appears.
84
4. Enter the following information:
Property Description
Name Name for the resource. The resource appears in the Resources panel with this name. The name
must be unique and have from one through 256 characters. It cannot include the following characters:
/ \ : * ' ? " < > | [ ]
Description Description for the resource. Description cannot exceed 4000 characters.
Hide in Summary
Lineage
Hides the resource in the summary view of data lineage diagrams.
Enable this option to hide the resource and its child objects in the summary view. Disable this option
to display the resource and its child objects in the summary view.
Default is disabled.
5. Click Finish.
The resource appears in the Resources panel on the Load tab. You can configure the template, source files
and schedules in the Resources panel after you create the template in the Custom Metadata Configurator.
Configuring the Template Name
You can configure the Template Name property for a custom resource. To edit the property, select the
custom resource in the Resources panel of the Load tab, click Edit Resource, and click the Configuration tab
in the Edit Resource window.
Enter the name of the custom resource template that stores information about how to map the metadata
object attributes to the class attributes. The template can also store the class associations between metadata
objects.
Adding or Removing Metadata Files for a Resource
Add a metadata file to a resource to configure the source from which Metadata Manager extracts metadata.
Remove a metadata file from a resource if you want to remove the metadata from the Metadata Manager
warehouse or load a different metadata source file.
You can add one metadata file for each resource. After you remove a metadata file, you can purge the
metadata from the Metadata Manager warehouse.
You can add or remove the following metadata files:
Metadata source files. Add or remove a metadata source file for packaged resource types.
Attribute and association files. Add or remove attribute and association files for a custom resource. You
must also add a metadata source file if the contents of an existing attribute and association file changes.
Configuring the Template Name 85
Note: To change the metadata in the source file that Metadata Manager loads into the Metadata Manager
warehouse, change the contents of the metadata source file and add the file again. You can also upload the
file to the following directory on the node that runs the Metadata Manager Service:
<Informatica installation directory>\services\MetadataManagerService\mm_files\<Metadata
Manager Service name>\mm_load\data_files\<resource ID>
1. On the Load tab, select the resource for which you want to add or remove files.
2. In the Resources panel, click the Configuration tab, and then click Edit.
The Edit Resources window appears.
3. To add a metadata source file, click Add and select the file.
If you configured Metadata Manager to use the latest source files, include an absolute path to the file
that is accessible from the Metadata Manager Service machine.
4. Optionally, direct Metadata Manager to update the metadata in the warehouse with the metadata in the
source file.
5. To remove a metadata source file, select the file and click Remove.
6. Click OK.
86 Chapter 6: Custom Resources
CHAPTER 7
Data Integration Resources
This chapter includes the following topics:
Informatica Platform Resources, 87
Microsoft SQL Server Integration Services Resources, 99
PowerCenter Resources, 110
Informatica Platform Resources
You can create and configure an Informatica Platform resource to extract metadata from applications and
resource files that you export from Informatica Developer (the Developer tool).
Developer tool users can make mappings, virtual databases, and scorecards available for data lineage in
Metadata Manager. To make mappings and virtual databases available for data lineage, Developer tool users
deploy the objects to an application. Developer tool users then deploy the application to a Data Integration
Service or to an application archive file. To make scorecards available for data lineage, Developer tool users
export the scorecards to a resource file for Metadata Manager. In Metadata Manager, you can create
Informatica Platform resources from an application or a resource file.
You can create an Informatica Platform resource from the following metadata sources:
Application deployed to a Data Integration Service
Multiple applications can run on a Data Integration Service. If you create an Informatica Platform
resource from applications that you deploy to a Data Integration Service, you can include metadata from
multiple applications in the resource.
Application archive file
An application archive file contains one application. If you create an Informatica Platform resource from
an application archive file, the resource contains metadata from the application that is deployed to the
application archive file.
Note: You can create Informatica Platform resources from version 9.5.1 - 9.6.x application archive files.
Metadata Manager cannot extract metadata from version 10.x application archive files.
Export resource file for Metadata Manager
An export resource file for Metadata Manager is an XML file that contains one or more scorecard
objects. If you create an Informatica Platform resource from an export resource file for Metadata
Manager, the resource contains metadata for all scorecards in the resource file.
87
Configuring the Metadata Source
Before you create an Informatica Platform resource, you might need to check the status of the Data
Integration Service or configure directory permissions. If you do not perform these tasks, the metadata load
can fail.
The tasks that you perform to configure the metadata source vary based on how you create the resource:
From an application that is deployed to a Data Integration Service
To ensure that Metadata Manager can extract and load metadata from the application, verify that the
Data Integration Service is available. When you create a resource, the application can be running or
stopped. When you load the resource, the application must be running.
From an application archive file
To ensure that Metadata Manager can extract and load metadata from the application, verify that the
Metadata Manager Service has read permission on the directory that contains the file.
From an export resource file for Metadata Manager
To ensure that Metadata Manager can extract and load metadata from the file, verify that the Metadata
Manager Service has read permission on the directory that contains the file.
Creating an Informatica Platform Resource
Create an Informatica Platform resource to extract metadata from an application or from an export resource
file for Metadata Manager.
1. On the Load tab, click Actions > New Resource.
The Resource Selection window appears.
2. Click Data Integration > Informatica Platform.
3. Click Next.
The Properties window appears.
4. Enter the following information:
Property Description
Name Name for the resource. The resource appears in the Resources panel with this name. The name must
be unique and have from one through 256 characters. It cannot include the following characters:
/ \ : * ' ? " < > | [ ]
Note: If you create a resource from a resource file, you must use the following naming convention for
the resource name:
<Model repository Service name>_<project name>
Description Description for the resource. Description cannot exceed 4000 characters.
Hide in
Summary
Lineage
Hides the resource in the summary view of data lineage diagrams.
Enable this option to hide the resource and its child objects in the summary view. Disable this option to
display the resource and its child objects in the summary view.
Default is disabled.
5. Click Next.
The Configuration window appears.
88 Chapter 7: Data Integration Resources
6. Select one of the following options for the source system version:
Option Description
Informatica Platform 10.1
(Repository)
Create the resource from a version 10.1 application that is deployed to a Data
Integration Service.
Informatica Platform 10.0
(Repository)
Create the resource from a version 10.0 application that is deployed to a Data
Integration Service.
Informatica Platform 9.5.1 - 9.6.x
(Repository)
Create the resource from a version 9.5.1 - 9.6.x application that is deployed to a
Data Integration Service.
Informatica Platform 9.5.1 - 9.6.x
(Archive File)
Create the resource from a version 9.5.1 - 9.6.x application archive file.
Informatica Platform 9.5.1 - 10.x
(Resource File)
Create the resource from a version 9.5.1 - 10.x resource file that you exported
from the Developer tool.
Note: If you extract metadata from an Informatica 10.x application, you must select source system
version Informatica Platform 10.1 (Repository) or Informatica Platform 10.0 (Repository). Metadata
Manager cannot extract metadata from version 10.x application archive files.
7. Configure the resource connection properties.
8. If you create a resource from an application that is deployed to a Data Integration Service, click Test
Connection to test the connection to the Data Integration Service.
If Metadata Manager cannot connect to the Data Integration Service, an error message appears. Correct
the error, and test the connection again.
9. Click Next.
10. If you create a resource from an application that is deployed to a Data Integration Service, the
Parameters window appears.
The Parameters window displays all of the applications that are deployed to the Data Integration
Service.
Select the applications that you want to include in the resource, and click Next.
11. If you create a resource from a version 10.x application that is deployed to a Data Integration Service,
the Parameter Set Assignment window appears.
The Parameter Set Assignment window displays the parameter sets in each selected application. You
can assign a parameter set to one or more mappings. If you assign a parameter set to a mapping,
Metadata Manager extracts metadata for the mapping based on the parameter values defined in the
parameter set. If you do not assign a parameter set and the mapping uses parameters, Metadata
Manager extracts metadata for the mapping based on the parameter default values.
To assign a parameter set:
a. In the Applications list, select the application that contains the parameter set that you want to
assign to one or more mappings.
b. In the Parameter Set list, select the parameter set.
Informatica Platform Resources 89
c. In the Mappings list, select the mappings to which you want to assign the parameter set, and click
Assign. To assign the parameter set to all mappings, click Assign to all.
Metadata Manager lists the parameter set assignments at the bottom of the Parameter Set
Assignment window.
To remove a parameter set assignment, click X next to the parameter set assignment that you want
to remove.
When you finish the parameter set assignment, click Next.
12. The Schedules window appears. To add a schedule, select Attach a Schedule, and select a schedule
in the Schedule list.
If you have not created a schedule, you can assign a schedule to a resource after you create the
resource.
13. Click Finish.
The resource appears in the Resources panel on the Load tab.
Data Integration Service Connection Properties
If you create a resource from an application that is deployed to a Data Integration Service, you must provide
connection information for the Data Integration Service.
The following table describes the connection properties:
Property Description
Source system
version
Name and version of the metadata source. Select one of the following options based on the
application version:
-Informatica Platform 10.1 (Repository)
-Informatica Platform 10.0 (Repository)
-Informatica Platform 9.5.1 - 9.6.x (Repository)
Host Name of the gateway node in the Informatica domain.
Port Port number for the gateway node.
Security domain Security domain for the Administrator tool user.
If the domain uses LDAP authentication or Kerberos authentication, enter the security domain name.
Otherwise, enter
Native
.
User name Name of the Administrator tool user. The user must have the Manage Applications privilege on the
Data Integration Service.
Password Password for the Administrator tool user.
DIS service name Name of the Data Integration Service where the application is deployed.
10.0 Command Line
Utilities Directory
File path to the 10.0 Informatica Command Line Utilities installation directory. This property is
displayed when you select source system version Informatica Platform 10.0 (Repository).
Must be an absolute path that the 10.1 Metadata Manager Service can access, for example,
C:
\Informatica\100_CLU
.
Auto assign
connections
Metadata Manager configures connection assignments to relational database resource types during
the resource load. If you disable this option, configure connection assignments in the resource
properties after you create the resource.
90 Chapter 7: Data Integration Resources
Application Archive File Connection Properties
If you create an Informatica Platform resource from an application archive file, you must provide the file path
and file name.
The following table describes the connection properties:
Property Description
Source system
version
Name and version of the metadata source. Select Informatica Platform 9.5.1 - 9.6.x (Archive File).
Always use latest
source files
Uses the application archive file in the location you provide each time you load the resource. If you
enable this option, the path to the file must include an absolute path that the Metadata Manager Service
can access. If you disable this option, Metadata Manager copies the application archive file to the
Metadata Manager application directory when you finish configuring the resource. Each time you load
the resource, Metadata Manager uses the copied application archive file in the Metadata Manager
application directory.
Auto assign
connections
Metadata Manager configures connection assignments to relational database resource types during the
resource load. If you disable this option, configure connection assignments in the resource properties
after you create the resource.
Application archive File path and file name for the application archive file.
Resource File Connection Properties
If you create an Informatica Platform resource from a resource file, you must provide the file path and file
name.
The following table describes the connection properties:
Property Description
Source system
version
Name and version of the metadata source. Select Informatica Platform 9.5.1 - 10.x (Resource File).
Always use latest
source files
Uses the resource file in the location you provide each time you load the resource. If you enable this
option, the path to the file must include an absolute path that the Metadata Manager Service can
access. If you disable this option, Metadata Manager copies the resource file to the Metadata Manager
application directory when you finish configuring the resource. Each time you load the resource,
Metadata Manager uses the copied resource file in the Metadata Manager application directory.
Auto assign
connections
Metadata Manager configures connection assignments to relational database resource types during the
resource load. If you disable this option, configure connection assignments in the resource properties
after you create the resource.
Resource file File path and file name for the resource file.
Command Line Utilities Installation for Version 10.0 Applications
To extract metadata from an Informatica 10.0 application that is deployed to a Data Integration Service, you
must install the version 10.0 Command Line Utilities. Install the utilities in a directory that the 10.1 Metadata
Manager Service can access. If you don't install the utilities, the resource load can fail.
The 10.0 Command Line Utilities are included in the Command Line Utilities zip file. Contact Informatica
Global Customer Support to get the zip file.
Informatica Platform Resources 91
Extract the files to a directory that the 10.1 Metadata Manager Service can access. For best performance,
extract the files to a directory on the machine that runs the Metadata Manager Service. If you extract the files
to a different machine, the Metadata Manager Service can take several minutes to access the directory.
Note: After you install standalone command line utilities, you normally have to perform the following tasks:
On Windows, install the Microsoft Visual Studio 2013 redistributable package.
Configure the path and environment variables as required by the command line utilities.
Create the domains.infa file.
When you install the version 10.0 Command Line Utilities for an Informatica Platform resource that extracts
metadata from a version 10.0 application, you do not have to perform these tasks.
Parameters in Informatica Platform 10.x Resources
If an Informatica Platform 10.x application includes a mapping that uses parameters, you can configure
Metadata Manager to use the parameter values when you load the resource. Metadata Manager can use
parameter values that are defined in a parameter set. Metadata Manager cannot use parameter values that
are defined a parameter file.
A parameter set is an object in the Model repository that contains mapping parameter values. These values
override the default parameter values that a Developer tool user configures for objects within a mapping.
Metadata Manager can use parameter values that represent the following objects:
Connections, table owner names, and table names for relational sources, targets, and lookups
Names and directories for flat files
You assign a parameter set to one or more mappings when you create an Informatica Platform resource.
Metadata Manager uses the parameter values defined in the parameter set to display the mapping objects
and to display data lineage. If a mapping uses parameters and you do not assign a parameter set to the
mapping, Metadata Manager uses the parameter default values.
Parameter Set Example
If you assign a parameter set to a mapping, Metadata Manager displays the mapping in the metadata catalog
and displays data lineage for the mapping based on the parameter values.
For example, an application contains the following mapping that reads data from an Oracle table, filters the
data, and writes data to a flat file:
To change the source database between mapping runs, the mapping designer creates a connection
parameter for the source connection and assigns it the default value Ora_DEV. The mapping designer
creates a parameter set, PRODUCTION, and sets the source connection to Ora_PROD.
92 Chapter 7: Data Integration Resources
In Metadata Manager, you want to view the mapping and display lineage links with the values defined in the
PRODUCTION parameter set. Assign the PRODUCTION parameter set to the mapping when you create the
resource.
When you load the resource, Metadata Manager extracts the mapping using the parameter values defined in
the parameter set. Therefore, when you view the resource on the Load tab, the Connection Assignment tab
shows the connection as Ora_PROD. If you run data lineage on the mapping and select the relational source,
Metadata Manager displays the connection name as Ora_PROD. Metadata Manager creates lineage links
based on the Ora_PROD connection.
Parameter Set Rules and Guidelines
Consider the following rules and guidelines when you assign a parameter set to one or more mappings in a
resource:
Parameter set assignment for a mapping is optional.
If you do not assign a parameter set to a mapping that uses parameters, Metadata Manager extracts the
mapping using the parameter default values.
You can assign one parameter set to each mapping in a resource.
Therefore, you cannot extract different versions of a mapping in the same resource. If you want to see
metadata for different mapping versions, create multiple resources and assign a different parameter set
to the mapping in each resource.
You can assign the same parameter set to multiple mappings.
If a parameter set is used in multiple mappings, you can assign the parameter set to multiple mappings.
The parameter set and the mappings must be in the same application.
Metadata Manager cannot use parameter values for parameters in transformation expressions or conditions.
Developer tool users can use parameters in expressions or conditions in transformations such as the
Aggregator, Filter, Expression, Joiner, or Lookup transformation. For example, a Developer tool user can
use a parameter in the join condition of a Joiner transformation. Metadata Manager cannot use
parameter values for parameters in transformation expressions or conditions. Metadata Manager uses
the default values for parameters in transformation expressions and conditions.
Metadata Manager cannot use parameter values for parameters in custom SQL queries.
Developer tool users can use parameters in custom SQL queries in customized data objects and Lookup
transformations. Metadata Manager cannot use parameter values for parameters in custom SQL queries.
Metadata Manager uses the default values for parameters in custom SQL queries.
You cannot use parameter sets with virtual table mappings.
If an application includes a virtual table mapping that uses parameters, Metadata Manager extracts the
virtual table mapping with the parameter default values.
Parameters in Informatica Platform 9.5.1 - 9.6.x Resources
If you create a resource from a version 9.5.1 - 9.6.x application that is deployed to a Data Integration Service,
Metadata Manager cannot read parameters that are associated with application objects.
Mappings in Informatica Developer applications can contain user-defined or system parameters. System
parameters define the directories where the Data Integration Service stores cache files, reject files, source
files, target files, and temporary files. User-defined parameters allow Developer tool users to define mapping
values and update those values each time the mapping runs. Metadata Manager cannot read mapping
parameters in version 9.5.1 - 9.6.x applications.
Informatica Platform Resources 93
For example, a Developer tool user assigns system parameter "SourceDir" as the source directory for a flat
file data object and includes the object in an application. The Informatica administrator sets the source
directory for the Data Integration Service process is to
<Informatica Services Installation Directory>/
tomcat/bin/source
. You create a resource that is based on the application and try to create links for the
resource. Metadata Manager cannot create links for the flat file data object because it reads the flat file
source directory as
SourceDir
instead of as
<Informatica Services Installation Directory>/
tomcat/bin/source
.
Reference
Informatica Platform resources have some restrictions on object types, data lineage, and object hierarchies.
Object Types Extracted and Not Extracted
Metadata Manager extracts most object types from Informatica Developer applications. However, it does not
extract some object types.
Metadata Manager can extract metadata for the following objects:
Mappings
SQL data services
Objects that are deployed as an SQL data service
Scorecards
Metadata Manager does not extract metadata for the following objects:
Reference tables
Sources and targets except for relational, customized, and flat-file data objects
Virtual stored procedure
Web services
Workflows
Unsupported Transformations
Metadata Manager supports metadata extraction for most transformations. However, Metadata Manager does
not support metadata extraction for some transformations.
Metadata Manager does not support metadata extraction for the following transformations:
Logical Data Object Lookup transformation
Reference Table Lookup transformation
When you view a mapping or mapplet that contains a transformation for which Metadata Manager does not
support metadata extraction, it might differ from the Developer tool mapping or mapplet. The mapping or
mapplet in Metadata Manager might also differ from the run-time version of the mapping or mapplet.
Dynamic Mappings in Informatica Platform 10.x Resources
Metadata Manager does not support metadata extraction for dynamic mappings.
In Informatica 10.x, Developer tool users can create dynamic mappings. A dynamic mapping is a mapping in
which you can change sources, targets, and transformation logic at run time based on parameters and rules
that you define. In a dynamic mapping, the source, target, or lookup schemas can change at run time. A
94 Chapter 7: Data Integration Resources
dynamic mapping can also contain ports that can receive new or changed columns based on the data flow in
a mapping.
Metadata Manager does not support metadata extraction for dynamic mappings. If an Informatica Platform
10.x application includes a dynamic mapping, you can create an Informatica Platform resource from the
application. However, when you view the dynamic mapping in Metadata Manager, the mapping might differ
from the corresponding Developer tool mapping and from the run-time version of the mapping.
Compiled Mappings in Informatica Platform 10.x Resources
Metadata Manager extracts the compiled version of mappings from Informatica Platform 10.x applications. In
the compiled version of a mapping, the mapplets, logical data objects, and parameters in the mapping are
expanded. Therefore, the mappings and logical data objects included in the mapping appear in the mapping
itself.
The compiled version of a mapping might differ from the corresponding mapping in the Developer tool.
For example, a Developer tool user creates the Customer logical data object. The following logical data
object mapping populates the Customer logical data object:
The Developer tool user uses the Customer logical data object as a source in mapping m_Customer.
The following image shows mapping m_Customer in the Developer tool:
If you create an Informatica Platform 10.x resource that includes mapping m_Customer, Metadata Manger
extracts the compiled version of the mapping. The compiled version of the mapping includes the
transformations in the logical data object mapping in addition to the transformations in mapping m_Customer.
The following image shows mapping m_Customer in the data lineage diagram:
Informatica Platform Resources 95
Data Quality Transformations in Informatica Platform 10.x Resources
When the Data Integration Service compiles a mapping, it expands some data quality transformations into
multiple transformations. Therefore, in Informatica Platform 10.x resources, Metadata Manager displays an
expanded form of some data quality transformations.
Metadata Manager displays an expanded form of the following data quality transformations:
Address Validator
Metadata Manager displays an Address Validator transformation and an Address Validator report.
Consolidation
Metadata Manager displays the following transformations:
Consolidation
Sorter
Decision
Exception
Metadata Manager displays the following transformations:
Exception
Sorter
Key Generator
Metadata Manager displays the following transformations:
Key Generator
Sorter
Match
Metadata Manager displays the following transformations:
Sorter
Expression
Pair Generator*
Comparison
Weighted Average
Cluster*
* The Data Integration Service generates these transformations when it compiles the mapping. These
transformations do not appear in the Developer tool.
Metadata Manager might also display an additional mapplet.
Multi-Strategy transformations
Metadata Manager displays one instance of the transformation for each strategy.
96 Chapter 7: Data Integration Resources
Mappings that are not Valid in Informatica Platform 10.x Resources
Metadata Manager cannot extract metadata for a mapping that is not valid. If an Informatica Platform 10.x
application contains a mapping that is not valid after compilation, Metadata Manager does not load metadata
for the application.
For example, a Developer tool user creates a mapping with a Rank transformation where the Rank and
Group By ports are specified through parameters. The parameters that represent the Rank and Group By
ports are assigned the same value. A Rank transformation cannot use the same port for the Rank port and
the Group By port, so the mapping is not valid after compilation. Metadata Manager does not load metadata
for an application which contains a mapping that is not valid.
If the resource contains one application with a mapping that is not valid, Metadata Manager fails the
metadata load.
If the resource contains multiple applications, Metadata Manager does not load any application which
contains a mapping that is not valid. Metadata Manager logs an error in the load log for each application that
it cannot load. Metadata Manager continues to load the other applications in the resource.
Data Lineage Restrictions
Metadata Manager makes most Informatica Platform object types available for lineage. However, some
object types are not available for lineage.
The following object types are not available for lineage:
Application
Project
Folder
Key
Key relationship
Logical data object model
Virtual schema
Port-to-Port Data Lineage
Some Informatica Platform transformations contain separate input and output ports. For most transformations
that have separate input and output ports, Metadata Manager can determine the data lineage links between
the input ports and the output ports.
Transformations such as Aggregator, Expression, Joiner, and Union transformations can contain separate
input and output ports. Metadata Manager can determine the data lineage links between the input and output
ports in these transformations. Data lineage links between input and output ports in the same transformation
are called port-to-port data lineage links.
Informatica Platform Resources 97
The following image shows port-to-port data lineage links within a Union transformation:
Metadata Manager can determine port-to-port data lineage for the following transformations that have
separate input and output ports:
Address Validator
Aggregator
Association
Case Converter
Classifier
Comparison
Consolidation
Decision
Exception
Expression
Joiner
Key Generator
Labeler
Match
Merge
Parser
Rank
Router
Standardizer
Union
98 Chapter 7: Data Integration Resources
Weighted Average
Metadata Manager cannot determine port-to-port data lineage for other transformations that have separate
input and output ports. When Metadata Manager cannot determine port-to-port data lineage for a
transformation, it maps all input ports to all output ports within the transformation.
Physical Data Objects in Multiple Applications
If a resource includes multiple applications that contain the same physical data object, Metadata Manager
extracts one instance of the physical data object in each application.
Metadata Manager displays data lineage and impact summary analysis for each instance of the object based
on the application in which the instance exists.
Objects with the Same Name in Informatica Platform 10.x Resources
Metadata Manager does not extract folders from version 10.x applications. Metadata Manager extracts all
physical data objects from each folder into one logical group called Physical Data Objects. Similarly,
Metadata Manager extracts all mappings from each folder into one logical group called Mappings.
If an application contains multiple physical data objects or mappings with the same name, the Physical Data
Objects or Mappings logical group shows multiple objects with the same name. To view the differences
between the objects, open the objects in the metadata catalog or run data lineage analysis.
Microsoft SQL Server Integration Services
Resources
You can create and configure a Microsoft SQL Server Integration Services resource to extract metadata from
Microsoft SQL Server Integration Services packages. Metadata Manager can extract metadata from
packages in the Microsoft SQL Server repository or from a package in a package file.
A package is a collection of connections, control flow elements, data flow elements, event handlers,
variables, and configurations that represents a unit of work. You can create a package with SQL Server
Integration Services graphical design tools or build it programmatically. You can save a package to Microsoft
SQL Server, the SQL Server Integration Services Package Store, or a package file.
If you extract metadata from packages in the Microsoft SQL Server repository, you can create one resource
to extract metadata from one or more packages. If the packages are encrypted with a password, all packages
within the resource must use the same password.
If you extract metadata from a package in an SQL Server Integration Services package file, you can create
one resource for each package file. The package file must be a .dtsx file.
Microsoft SQL Server Integration Services Resources 99
Metadata Extraction from Protected Packages
Metadata Manager can extract metadata from encrypted packages. However, there might be restrictions
based on the package protection level. For example, when the whole package is protected, you might have to
supply the package password or run the Metadata Manager Agent from a specific user account.
The following table describes the restrictions for each package protection level:
Protection Level Restrictions
-Do not save sensitive
-Encrypt sensitive with password
-Encrypt sensitive with user key
-Rely on server storage for
encryption
None. Metadata Manager can extract metadata from the package.
Encrypt all with password Metadata Manager can extract metadata from the package if you specify the password
when you create the resource. If you extract metadata from a Microsoft SQL Server
repository, all packages within the resource must use the same password.
Encrypt all with user key Metadata Manager can extract metadata from the package if the user account that you
use to start the Metadata Manager Agent is the same as the user account used to
create the package.
Configuring SQL Server Integration Services
Before you create an SQL Server Integration Services resource, you must configure the metadata source. If
you do not correctly configure the metadata source, the metadata load can fail or the metadata can be
incorrectly loaded in the Metadata Manager warehouse.
To configure SQL Server Integration Services, perform the following tasks:
Install the Metadata Manager Agent, if required.
To extract metadata from packages in the repository, verify that the Microsoft SQL Server Database
Engine is running.
Configure permissions.
Prepare the variable values file, if required.
Install the Metadata Manager Agent
When SQL Server Integration Services is not on the same machine as the Metadata Manager Service, you
must install the Metadata Manager Agent separately. Install the Metadata Manager Agent on a Windows
100 Chapter 7: Data Integration Resources
machine. The Metadata Manager Agent installation requirements vary based on the SQL Server Integration
Services source type.
The following table describes the Metadata Manager Agent installation requirements based on the SQL
Server Integration Services source type:
Source Type Metadata Manager Agent Requirements
Package file You can use the Metadata Manager Agent installed on any machine. If you configure Metadata
Manager to use the latest source files, the location of the source files must be accessible from the
Metadata Manager Agent machine.
Package in a Microsoft
SQL Server repository
The Metadata Manager Agent and SQL Server Integration Services must be on the same machine.
Related Topics:
“Step 2. Install the Metadata Manager Agent” on page 22
Verify Database Availability
To extract metadata from packages in a Microsoft SQL Server repository, verify that the Microsoft SQL
Server Database Engine is available and running.
Configure Permissions
You configure permissions differently based on whether you extract metadata from packages in the Microsoft
SQL Server repository or from a package in a package file.
If you extract metadata from packages in the repository, configure permissions for the Windows user who
starts the Metadata Manager Agent. The Metadata Manager Agent uses Windows authentication to connect
to SQL Server Integration Services. The Windows user who starts the Metadata Manager Agent must have
read permission on the objects that the Metadata Manager Agent extracts.
If you extract metadata from a package file and you configure Metadata Manager to use the latest source
files, the Windows user who starts the Metadata Manager Agent must have read permission on the file and
on the directory that contains the file.
Prepare the Variable Values File
If you extract metadata from packages that use variables, you can create a variable values file to define the
variables. Create a variable values file when the packages do not contain values for all variables or when you
want to override the values defined in the packages.
You specify the variable values file when you create the SQL Server Integration Services resource. Metadata
Manager uses the variable values file to resolve the variables. Metadata Manager can resolve variables that
specify the table or view name in an OLE DB source or destination. Metadata Manager can also resolve
variables that specify an SQL query in an OLE DB source. You cannot define SQL Server Integration
Services parameters in a variable values file.
To define variables in the variable values file, group the variables by scope, either package-level or task-
level. Define each variable on a separate line. You must also enter the namespace as a prefix.
Use the following syntax to define a variable that has a package-level scope:
[Package]
Namespace::Variable=Value
Microsoft SQL Server Integration Services Resources 101
Use the following syntax to define a variable that has a task-level scope:
[Package.Task]
Namespace::Variable=Value
Variable names are case sensitive.
If you define the same variable multiple times, Metadata Manager resolves the variables as follows:
If you define the variable in a package and in a task within the package, Metadata Manager uses the
value that you define for the task.
If you define the variable multiple times within a package or task, Metadata Manager uses the last value
that you define.
If you define a variable in the variable values file and the variable has a default value in the package,
Metadata Manager uses the value in the variable values file.
The following example shows a variable values file that defines variables for two tasks within a package:
[SSIS_Package_Configuration.Data Flow Task]
User::TargetTableName=PERSON_OUT
User::TableName=Person
[SSIS_Package_Configuration.SQL_From_Variable]
User::MySQL_Target=PERSON_OUT
User::MySQL=SELECT Name as FirstName, Name as LastName, Name as MiddleName FROM
Purchasing.Vendor
Creating an SQL Server Integration Services Resource
Create an SQL Server Integration Services resource to extract metadata from Microsoft SQL Server
Integration Services.
Before you create an SQL Server Integration Services resource, configure the SQL Server Integration
Services source.
1. On the Load tab, click Actions > New Resource.
The Resource Selection window appears.
2. Click Data Integration > Microsoft SQL Server Integration Services.
3. Click Next.
The Properties window appears.
4. Enter the following information:
Property Description
Name Name for the resource. The resource appears in the Resources panel with this name. The name
must be unique and have from one through 256 characters. It cannot include the following characters:
/ \ : * ' ? " < > | [ ]
Description Description for the resource. Description cannot exceed 4000 characters.
Hide in Summary
Lineage
Hides the resource in the summary view of data lineage diagrams.
Enable this option to hide the resource and its child objects in the summary view. Disable this option
to display the resource and its child objects in the summary view.
Default is disabled.
5. Click Next.
The Configuration window appears.
102 Chapter 7: Data Integration Resources
6. Select one of the following options for the Source system version:
Option Description
Microsoft SQL Server Integration Services
(File)
Create the resource from a package (.dtsx) file.
Microsoft SQL Server Integration Services
(Repository)
Create the resource from one or more packages in a Microsoft SQL
Server repository.
7. Configure the resource connection properties.
8. Click Test Connection.
Metadata Manager validates the Metadata Manager Agent URL.
If you extract metadata from a package file, Metadata Manager also validates the file. If you configure
Metadata Manager to use the latest source files, Metadata Manager validates that the file exists in the
specified path. If you upload the file to Metadata Manager, Metadata Manager validates that the file is
compatible with the resource type and version.
If you extract metadata from packages in a Microsoft SQL Server repository, Metadata Manager also
validates the connection information for the source system.
If Metadata Manager cannot validate the Metadata Manager Agent URL, validate the source file, or
connect to the repository, an error message appears. Correct the error and test the connection again.
9. Click Next.
The Schedules window appears.
10. To add a schedule, select Attach a Schedule, and select a schedule in the Schedule list.
If you have not created a schedule, you can assign a schedule to a resource after you create the
resource.
11. Click Finish.
The resource appears in the Resources panel on the Load tab.
SQL Server Integration Services File Configuration Properties
Update the configuration properties when you create or edit an SQL Server Integration Services resource that
is based on a package file.
The following table describes the configuration properties:
Property Description
Agent URL Host name and port number of the Metadata Manager Agent.
You can use the Metadata Manager Agent installed on any machine.
Source system
version
Name and version of the metadata source. Select Microsoft SQL Server Integration Services (File).
Always use latest
source files
Uses the metadata source file in the location you provide each time you load the resource. If you enable
this option, the path to the file must include an absolute path that is accessible from the Metadata
Manager Agent machine. If you disable this option, Metadata Manager copies the metadata source file to
the Metadata Manager application directory when you finish configuring the resource. Each time you load
the resource, Metadata Manager uses the copied metadata source file in the Metadata Manager
application directory.
Microsoft SQL Server Integration Services Resources 103
Property Description
Variable values
file
File that defines the values for the user-defined variables in the package. Specify a variable values file
when variables in the package do not have values or when you want to override the variable values
defined in the package.
The location of the variable values file must be accessible from the machine where the Metadata Manager
Service runs. When SQL Server Integration Services is not on the same machine as the Metadata
Manager Service, ensure that the variable values file is in a location that both SQL Server Integration
Services and the Metadata Manager Service can access.
Encoding Code page for Execute SQL task source files. Default is Western European (Windows-1252).
If the package does not contain an Execute SQL task with a file source, Metadata Manager ignores this
property.
Password Password for the package.
Required if the package is encrypted with a password. If you do not enter the password, the Metadata
Manager Agent cannot extract metadata from the package.
Optional if the values of sensitive properties in the package are encrypted with a password. Metadata is
not a sensitive property. Therefore, the Metadata Manager Agent can extract metadata whether or not
you specify the password.
Hide
transformation
scripts
Controls how Metadata Manager displays lineage for Script components that are used as transformations.
If you set this property to true, Metadata Manager does not display input or output ports for any
transformation script. The data lineage diagram shows links between all columns in the source object and
all columns in the target object.
If you set this property to false, Metadata Manager creates a separate object in the lineage diagram for
each transformation script.
Default is true.
Auto assign
connections
Metadata Manager configures connection assignments to relational database resource types during the
resource load. If you disable this option, configure connection assignments in the resource properties
after you create the resource.
File File path and file name for the resource file. Must be a .dtsx file.
SQL Server Integration Services Repository Configuration Properties
Update the configuration properties when you create or edit an SQL Server Integration Services resource
from one or more packages in a Microsoft SQL Server repository.
The following table describes the configuration properties:
Property Description
Agent URL Host name and port number of the Metadata Manager Agent.
To extract metadata from the SQL Server repository, the Metadata Manager Agent must be on the same
machine as the SQL Server Client components.
Source system
version
Name and version of the metadata source. Select Microsoft SQL Server Integration Services
(Repository).
SQL Server
version
Microsoft SQL Server version.
104 Chapter 7: Data Integration Resources
Property Description
Host Host name or IP address of the machine where SQL Server Integration Services run.
Password Password for the package. If you include multiple packages in a resource, the packages must use the
same password.
Required if the packages are encrypted with a password. If you do not enter the password, the Metadata
Manager Agent cannot extract metadata from the packages.
Optional if the values of sensitive properties in the packages are encrypted with a password. Metadata is
not a sensitive property. Therefore, the Metadata Manager Agent can extract metadata whether or not
you specify the password.
Variable values file File that defines the values for the user-defined variables in the package. Specify a variable values file
when variables in the package do not have values or when you want to override the variable values
defined in the package.
The location of the variable values file must be accessible from the machine where the Metadata
Manager Service runs. When SQL Server Integration Services is not on the same machine as the
Metadata Manager Service, ensure that the variable values file is in a location that both SQL Server
Integration Services and the Metadata Manager Service can access.
Hide
transformation
scripts
Controls how Metadata Manager displays lineage for Script components that are used as
transformations.
If you set this property to true, Metadata Manager does not display input or output ports for any
transformation script. The data lineage diagram shows links between all columns in the source object and
all columns in the target object.
If you set this property to false, Metadata Manager creates a separate object in the lineage diagram for
each transformation script.
Default is true.
Auto assign
connections
Metadata Manager configures connection assignments to relational database resource types during the
resource load. If you disable this option, configure connection assignments in the resource properties
after you create the resource.
Package Names of the SQL Server Integration Services packages from which you want to extract metadata. Click
Select to select one or more packages.
Reference
After you create and load an SQL Server Integration Services resource, you can view and run data lineage
on the metadata objects that Metadata Manager extracted.
Objects Extracted
Metadata Manager extracts metadata for different SQL Server Integration Services objects.
Connection Manager Types
Metadata Manager extracts metadata for the following connection manager types:
OLEDB
FLATFILE
Control Flow Tasks
Metadata Manager extracts metadata for the following tasks in a control flow:
Microsoft SQL Server Integration Services Resources 105
Data Flow
Metadata Manager displays a summary of each data flow that a package contains.
Execute SQL
If the SQL statement creates or truncates a table, Metadata Manager displays the table structure.
However, Metadata Manager does not display data lineage for the table.
Transformations in a Data Flow
Metadata Manager can display a summary of the data flow when the data flow contains any of the following
transformations:
Aggregate
Audit
Character Map
Conditional Split
Copy Column
Data Conversion
Derived Column
Export Column
Fuzzy Grouping
Fuzzy Lookup
Import Column
Lookup
Merge
Merge Join
Multicast
Percentage Sampling
Pivot
Row Count
Row Sampling
Script Component
Slowly Changing Dimension
Sort
Term Extraction
Term Lookup
Union All
Unpivot
Note: Metadata Manager does not display individual transformations in the metadata catalog or in the data
lineage diagram.
106 Chapter 7: Data Integration Resources
Objects Not Extracted
Metadata Manager does not extract metadata for some SQL Server Integration Services objects that can
affect data movement.
Tasks Not Extracted
Metadata Manager does not extract metadata for the following tasks that can affect data movement:
Bulk Insert Task
Data Mining Query Task
Data Profiling Task
Execute Package Task
Execute T-SQL Statement Task
Any task that contains code written in T-SQL, Visual Basic, or C#
Transformations Not Extracted
Metadata Manager does not extract metadata for the following transformations that can affect data
movement:
Cache Transform
OLE DB Command
Any transformation that contains code written in T-SQL, Visual Basic, or C#
Organization of Objects in the Metadata Catalog
When you load an SQL Server Integration Services resource, Metadata Manager organizes SQL Server
Integration Services objects in the metadata catalog according to the connections in which the objects are
used. To select an object such as a column in the metadata catalog, navigate to the object through the
source or target connection in which the object is used.
For example, package HypoStores_HR contains a data flow that reads data from the EMPLOYEE table in a
relational database. The OLE DB source connection object HR_DB contains the connection to the database
that contains the EMPLOYEE table. To navigate to the EMPLOYEE table in the metadata catalog, expand the
HR_DB source connection in the Connections group.
The following example shows the metadata catalog hierarchy for a data attribute such as a column:
<Packages>
Connections
<Source/Target>
<Package> (schema, directory, etc.)
<Data Set> (table, file, etc.)
<Data Attribute>
<Summary Content>
<Summary Model>
Connections
<Source/Target>
<Package>
<Data Set>
<Data Attribute>
Task Variables Store (Connection class)
Microsoft SQL Server Integration Services Resources 107
Package Summary
When you load an SQL Server Integration Services resource, Metadata Manager displays a summary of each
package in the metadata catalog and in the data lineage diagram. The package summary includes the source
and target data sources for each data flow in the package.
When you run data lineage on a summary, Metadata Manager displays the source and target data sources
and the lineage links between them. Metadata Manager does not display individual transformations in the
lineage diagram or in the metadata catalog. Metadata Manager also does not display columns that are added
by transformations in the data flow.
For example, a package contains one data flow with a Derived Column transformation followed by a
Conditional Split transformation. The data flow reads data from the PERSON table in a relational database. It
writes data to the EMAIL_PROMO and NO_EMAIL_PROMO tables in a different database.
When you expand the data flow summary in the data lineage diagram, the diagram displays the following
objects:
The OLE DB source connection object that contains the PERSON table.
The OLE DB destination connection object that contains the EMAIL_PROMO and NO_EMAIL_PROMO
tables.
You can expand the connection objects to display lineage links between the tables. Metadata Manager does
not display the two transformations in the lineage diagram.
Metadata Extraction Rules for Sources and Destinations
Metadata Manager extracts metadata from sources and destinations in the data flow according to different
metadata extraction rules.
Metadata Manager applies different metadata extraction rules for the following types of sources and
destinations in a data flow:
Destination
Metadata Manager applies the following metadata extraction rules for flat file and OLE DB destinations:
Metadata Manager derives data type and length for target columns from the corresponding source
column, not from the corresponding column in the destination data store.
For example, a data flow writes data from a source column with data type CHAR[50] to a column in a
database with data type CHAR[100]. When you view the target column in Metadata Manager,
Metadata Manager displays the data type for the target column as CHAR[50].
When multiple source columns load data to the same destination column and the source column
lengths differ, Metadata Manager determines the target column length from either source column.
Metadata Manager selects the source column that it encounters first in the metadata source.
For example, a data flow contains a Union All transformation that merges data in the NAME column
from two source columns with data types CHAR[255] and CHAR[100]. Metadata Manager displays
the NAME column length in the target object as either 255 or 100.
OLE DB Destination
If you use an SQL command to load data, Metadata Manager displays the SQL command in the SQL
property in the package summary.
Destination for error output
Metadata Manager displays the destination for error output as a target object.
108 Chapter 7: Data Integration Resources
Source
If there is a mismatch in length between an external column in a flat file or OLE DB source and the
corresponding output column, Metadata Manager derives the column length from the shorter of the two
columns.
OLE DB Source
If you use an SQL command to extract data, Metadata Manager displays the SQL command in the SQL
property in the package summary.
Metadata Extraction Rules for Transformations
Metadata Manager extracts different metadata from the data flow based on the types of transformations that
are present in the data flow.
Metadata Manager applies different metadata extraction rules when the following transformations are present
in the data flow:
Audit transformation
This transformation adds columns to the data flow. Metadata Manager displays columns that originate
from the source but not columns that are added by transformations in the data flow. Therefore, Metadata
Manager does not update the target object with any column that the Audit transformation adds to the
data flow.
Aggregate, Character Map, Data Conversion, Derived Column transformations
These transformations apply function expressions to columns values, for example,
AVG(SalesAmount)
or
UPPERCASE(LastName)
. Metadata Manager displays the function expressions in the Operation property
in the target column. If multiple expressions apply to a target column, Metadata Manager concatenates
the expressions.
Copy Column transformation
This transformation copies input columns and creates new columns in the transformation output.
Because the copied columns originate from the source, Metadata Manager displays the new columns in
the target.
Export Column transformation
This transformation inserts data into one or more flat files. Because the flat files originate from the
transformation, Metadata Manager does not display them in the metadata catalog or in the data lineage
diagram.
Fuzzy Lookup, Lookup, Term Lookup transformations
Metadata Manager displays the reference data set as a source object. Metadata Manager displays only
the return columns in the reference data set.
Pivot transformation
In the Pivot transformation, each input column has a unique lineage ID and each output column has a
source column. Metadata Manager creates a lineage link when the lineage ID value in an input column
matches the source column value in an output column.
Script component
The Script component can be used as a source, target, or transformation. Metadata Manager groups all
Script components under a connection called “_Scripts_” in the metadata catalog. Metadata Manager
displays each Script component input and output group as a data set. It also displays each input and
output column as a data attribute.
Microsoft SQL Server Integration Services Resources 109
When the Script component is used as a source or target, Metadata Manager displays it in the data
lineage diagram as a source or target object. When the Script component is used as a transformation,
Metadata Manager uses the Hide transformation scripts configuration property to determine how to
display the transformation logic.
Metadata Manager displays the transformation logic in the following ways based on the value of the Hide
transformation scripts configuration property:
If the property is true, Metadata Manager does not display the transformation inputs or outputs. The
data lineage diagram shows links between all columns in the source object and all columns in the
target object.
If the property is false, Metadata Manager creates a separate object in the lineage diagram to
represent each input or output group of a transformation script. The data lineage diagram displays
links between the source object and the transformation script inputs and between the transformation
script outputs and the target. However, it does not display links between the transformation script
inputs and outputs. To define the flow of metadata within a transformation script, use rule-based links
or enumerated links to link data attributes to each other. You can also use rule-based links or
enumerated links to link transformation scripts to other metadata objects.
Expressions in Multiple Data Flows
A control flow can contain multiple data flows. If the data flows apply different expressions to the same
destination column, Metadata Manager displays all of the expressions in the Operation property in the target
column. Metadata Manager separates the expressions with the semicolon character (;).
PowerCenter Resources
You can create and configure PowerCenter resources to extract metadata from Informatica PowerCenter.
Informatica PowerCenter allows you to load data into a centralized location, such as a data warehouse or
operational data store (ODS). You can extract data from multiple sources, transform the data according to
business logic, and load the transformed data into targets.
Configuring PowerCenter
Before you create a PowerCenter resource, you must configure the metadata source. If you do not correctly
configure the metadata source, the metadata load can fail or the metadata can be incorrectly loaded in the
Metadata Manager warehouse.
To configure PowerCenter, complete the following tasks:
Configure permissions.
Check in versioned repository objects.
If the PowerCenter repository is on an IBM DB2 for LUW database, configure the database heap size.
If the PowerCenter repository is on an Oracle 11.1 database, disable extended statistics.
110 Chapter 7: Data Integration Resources
Configure Permissions
To extract metadata from a PowerCenter repository, the login user that you specify in the resource
connection properties must be the PowerCenter repository database user.
The PowerCenter repository database user account requires the following permissions on the PowerCenter
repository database:
Select table
Select view
Create view
Note: After you upgrade Metadata Manager, you need the create view permission on the PowerCenter
repository database only during the first load.
Drop view
In addition, if the PowerCenter repository is on IBM DB2 for LUW, the user account also requires create and
drop function permissions.
Check in Versioned Repository Objects
To extract from a versioned PowerCenter repository, check in objects that you want Metadata Manager to
extract. Before loading PowerCenter resources, check out impacted objects, validate them and then check in
the objects.
Metadata Manager extracts the latest version of objects that are checked into a PowerCenter repository.
Metadata Manager does not extract objects that are checked out.
IBM DB2 for LUW Database Heap Size
When you load metadata from a PowerCenter repository that is on an IBM DB2 for LUW database, you must
modify the heap size. Otherwise, the S_M_ELEMNT_ATTR_EXTRACT session fails with the following error:
DBA2191E SQL execution error.
com.ibm.db.DataException: A database manager error occurred. :
[IBM][CLI Driver][DB2/NT] SQL0973N Not enough storage is available in
the "APP_CTL_HEAP_SZ" heap to process the statement. SQLSTATE=57011
This problem occurs when there is not enough storage available in the database application heap to process
the request.
Increasing the IBM DB2 for LUW Database Heap Size
To increase the IBM DB2 for LUW database heap size, complete the following steps:
1. Log out of Metadata Manager.
2. Stop the DB2 database server.
3. From a DB2 command prompt, connect to the DB2 database.
4. To determine the current value of the Application Heap Size configuration parameter
(APP_CTL_HEAP_SZ), run the following command:
db2 get db dfg for <database_name> | find "APP_CTL_HEAP_SZ"
5. To increase the size of APP_CTL_HEAP_SZ to 16384 or higher, run the following command:
db2 update db cfg for <database_name> using APP_CTL_HEAP_SZ <higher_value>
6. Restart the DB2 database server.
PowerCenter Resources 111
Disable Extended Statistics on Oracle 11.1
When you load metadata from a PowerCenter repository that is on an Oracle 11.1 database, you must
disable extended statistics on the database. Otherwise, the S_M_ELMNT_ATTR_FIRST_LOAD session
hangs during the load of the PowerCenter resource.
Extended statistics gathers object statistics and histograms on expressions or on a group of columns.
To disable extended statistics, set the Oracle system parameter
_optimizer_enable_extended_stats
to
FALSE. Run the following command on the Oracle database:
Alter system set "_optimizer_enable_extended_stats" = FALSE scope=spfile/both/memory;
For more information about this Oracle parameter, see the Oracle documentation.
Creating a PowerCenter Resource
Before you create a PowerCenter resource, configure the PowerCenter source.
1. On the Load tab, click Actions > New Resource.
The Resource Selection window appears.
2. Click Data Integration > PowerCenter.
3. Click Next.
The Properties window appears.
4. Enter the following information:
Property Description
Name Name for the resource. The resource appears in the Resources panel with this name. The name
must be unique and have from one through 256 characters. It cannot include the following characters:
/ \ : * ' ? " < > | [ ]
Description Description for the resource. Description cannot exceed 4000 characters.
Hide in Summary
Lineage
Hides the resource in the summary view of data lineage diagrams.
Enable this option to hide the resource and its child objects in the summary view. Disable this option
to display the resource and its child objects in the summary view.
Default is disabled.
5. Click Next.
The Configuration window appears.
6. Configure the connection properties.
7. Click Test Connection to test the connection to the source system.
If Metadata Manager cannot connect to the source system, an error message appears. Correct the error
and test the connection again.
8. Click Next.
The Parameters window appears.
9. Configure the folders to extract metadata from.
To add folders to the Selected Folders list, select the folder in the Available Folders list and click Add.
To add all available folders, click Add All.
112 Chapter 7: Data Integration Resources
To remove folders from the Selected Folders list, select the folder in the Selected Folders list and click
Remove. To remove all folders from the Selected Folders list, click Remove All.
10. Configure the number of days for the Source Increment Extract window.
11. Click Next.
The Parameter Files window appears.
12. To upload parameter files, click Upload.
13. To remove an uploaded parameter file, select the file and click Delete.
14. Click Auto-assign to direct Metadata Manager to analyze the PowerCenter repository and automatically
assign the uploaded parameter files to each workflow that specifies the parameter file name.
Or, select a parameter file in the Parameter Files list, select one or more folders or workflows in the
Workflow Folders list, and click Assign.
Or, select a parameter file and click Assign to All to assign the parameter file to all workflows.
Note: When you configure a PowerCenter workflow, if you use an absolute file name or the
$PMFolderName and $PMWorkflowName workflow variables to specify the parameter file name,
Metadata Manager uses this value to automatically assign the parameter file to the workflow. If you use
any other workflow variable for configuring the parameter file name, you must manually assign the
parameter file to the workflow.
15. To remove a parameter file from a workflow, click Remove for the parameter file in the bottom panel.
16. Click Next.
The Schedules window appears.
17. To add a schedule, select Attach a Schedule, and select a schedule in the Schedule list.
If you have not created a schedule, you can assign a schedule to a resource after you create the
resource.
18. Click Finish.
The resource appears in the Resources panel on the Load tab.
PowerCenter Connection Properties
If you create a PowerCenter resource, you must provide connection information for PowerCenter.
The following table describes the connection properties:
Property Description
Login user Database user name for the PowerCenter repository database.
Login password Database user password for the PowerCenter repository database.
Database type Type of database for the PowerCenter repository. Database type can be IBM DB2 for LUW, Microsoft SQL
Server, Oracle, or Sybase ASE.
Schema name Schema name for the PowerCenter repository database when the database type is IBM DB2 for LUW and
the schema name differs from the login user name. If you do not enter a value for this property, Metadata
Manager assumes that the schema name is the same as the login user name.
Metadata Manager does not display this property for database types other than IBM DB2 for LUW.
PowerCenter Resources 113
Property Description
Source JDBC
URL
JDBC URL for the PowerCenter repository database. Enter the database host name and the database
service name. Metadata Manager uses this URL to verify connection information to the source database.
For example, if the PowerCenter repository database is an Oracle database, use the following syntax:
jdbc:informatica:oracle://[host name]:[port];SID=[sid]
You can enter the SID or edit the string to use the full service name. For example:
jdbc:informatica:oracle://[host name]:[port];ServiceName=[service name]
If the Oracle database is clustered, use the following syntax:
jdbc:informatica:oracle://[host1]:[port];ServiceName=[service
name];AlternateServers = ([host2]:[port]);LoadBalancing=true
If the Oracle database uses the Advanced Security Option, use the following syntax:
jdbc:informatica:oracle://[host name]:
[port];SID=[SID];EncryptionLevel=[encryption
level];EncryptionTypes=[encryption types];DataIntegrityLevel=[data
integrity level];DataIntegrityTypes=[data integrity types]
Secure JDBC
parameters
Secure JDBC parameters that you want to append to the JDBC connection URL. Use this property to specify
secure connection parameters such as passwords. Metadata Manager does not display secure parameters
or parameter values in the resource configuration properties. Enter the parameters as name=value pairs
separated by the delimiter character that the database driver requires. For example:
param1=value1;param2=value2
If secure communication is enabled for the database, enter the secure JDBC parameters in this property.
Connect string Native connect string for the PowerCenter repository database. The Metadata Manager Service uses the
connect string to create a connection object to the Metadata Manager repository database in the
PowerCenter repository.
The connect string syntax varies based on the database type:
-IBM DB2 for LUW.
<database name>
-Microsoft SQL Server.
<server name>@<database name>
-Oracle.
<database name>.world
(same as the TNSNAMES entry)
-Sybase ASE.
<server name>@<database name>
Encoding Code page for the PowerCenter repository database.
The code page for the PowerCenter resource, the Metadata Manager repository, and the machine where the
associated Integration Service for Metadata Manager runs must be the same.
Auto assign
connections
Metadata Manager configures connection assignments to relational database resource types during the
resource load. If you disable this option, you must configure connection assignments in the resource
properties after you create the resource.
Use trusted
connection
Authenticates the user credentials using Windows authentication and establishes a trusted connection to a
Microsoft SQL Server PowerCenter repository database.
When you use a trusted connection to connect to Microsoft SQL Server database, the Metadata Manager
Service connects to the repository with the credentials of the user logged in to the machine on which the
service is running.
114 Chapter 7: Data Integration Resources
JDBC Parameters for Secure Databases
If secure communication is enabled for the PowerCenter repository database, you must append additional
parameters to the JDBC connection URL. To append the parameters, enter them in the Secure JDBC
Parameters property.
Append the following parameters to the URL:
;EncryptionMethod=SSL;TrustStore=<truststore
location>;TrustStorePassword=<password>;HostNameInCertificate=<host
name>;ValidateServerCertificate=<true|false>;KeyStore=<keystore
location>;keyStorePassword=<password>
Configure the parameters as follows:
EncryptionMethod
Encryption method for data transfer between Metadata Manager and the database server. Must be set to
SSL.
TrustStore
Path and file name of the truststore file that contains the security certificate of the database server.
TrustStorePassword
Password used to access the truststore file.
HostNameInCertificate
Host name of the machine that hosts the secure database. If you specify a host name, the Metadata
Manager Service validates the host name included in the connection string against the host name in the
security certificate.
ValidateServerCertificate
Indicates whether the Metadata Manager Service validates the certificate that the database server
presents. If you set this parameter to true, the Metadata Manager Service validates the certificate. If you
specify the HostNameInCertificate parameter, the Metadata Manager Service also validates the host
name in the certificate.
If you set this parameter to false, the Metadata Manager Service does not validate the certificate that the
database server presents. The Metadata Manager Service ignores any truststore information that you
specify.
KeyStore
Path and file name of the keystore file that contains the security certificates that the Metadata Manager
Service presents to the database server.
KeyStorePassword
Password used to access the keystore file.
Configuring the Folder Inclusion List
You can configure the Folder Inclusion List parameter for a PowerCenter resource. To edit the parameter,
select the resource in the Resources panel of the Load tab, click Edit Resource, and click the Parameters tab
in the Edit Resource window.
Use the Folder Inclusion List parameter to specify folders of PowerCenter objects that you want to load into
the Metadata Manager warehouse. You can load PowerCenter folders to limit the objects that Metadata
Manager extracts. Load the folders that Metadata Manager users need to analyze. The PowerCenter
resources load faster if they do not load all folders. You can configure up to 1,000 folders.
PowerCenter Resources 115
If you include a folder containing shortcuts to a source definition, target definition, reusable transformation,
mapping, or mapplet, you must also include the folder containing the original object. Otherwise, data lineage
might not display correctly.
By default, Metadata Manager excludes all PowerCenter folders. If you do not include any folder, Metadata
Manager extracts PowerCenter metadata not associated with a PowerCenter folder, such as metadata for
PowerCenter Integration Services.
If you change the folders for Metadata Manager to extract and remove previously loaded folders, Metadata
Manager does not delete any metadata object from the Metadata Manager warehouse. To delete metadata
objects in the Metadata Manager warehouse that no longer exist in the PowerCenter repository, purge the
metadata for the resource. You can then load the folders that you want in the Metadata Manager warehouse.
Configuring the Source Increment Extract Window
You can configure the Source Increment Extract Window (in Days) parameter for a PowerCenter resource.
To edit the parameter, select the resource in the Resources panel of the Load tab, click Edit Resource, and
click the Parameters tab in the Edit Resource window.
To verify a full extract during a resource load, the resource is configured to extract source records that have
been inserted or updated within the past 8,000 days of the extract. The default value for the parameter is
8,000.
After the initial extract completes, reset the parameter value based on the frequency at which you load the
metadata for the resource. As a guideline, set the parameter value to at least twice the number of days
between resource loads. For example, if you load the resource every two days, set the parameter value to
four. By doubling the amount of time, Metadata Manager extracts metadata for the current and previous time
period. If the previous load fails, Metadata Manager extracts information for the previous period and the
current period.
If you do not reset the default parameter value, Metadata Manager extracts metadata for the past 8,000 days
when you load the resource.
Note: The first time you load a PowerCenter resource, Metadata Manager may reject objects created before
the incremental extract period.
PowerCenter Parameter Files
If a PowerCenter source repository uses parameter files in sessions and workflows, you can configure
Metadata Manager to read the parameter files when you load the PowerCenter resource. PowerCenter
parameters can represent flat file sources, flat file lookups, flat file targets, relational connections, or objects
in SQL overrides. Metadata Manager can read the parameter files to extract metadata for the flat file sources,
flat file lookups, flat file targets, relational connections, and objects in SQL overrides.
Assign parameter files to PowerCenter workflows to perform data lineage analysis between the PowerCenter
repository and the metadata in the flat file sources, flat file lookups, flat file targets, relational connections, or
objects in SQL overrides. Metadata Manager uses the information in the parameter files to display data
lineage.
To assign the parameter files, you upload the parameter files to the node running the Metadata Manager
application. After you upload the parameter files, you assign the parameter files to individual workflows or to
all workflows in the PowerCenter repository. You can also direct Metadata Manager to automatically assign
the parameter files to the appropriate workflows in the PowerCenter repository.
After you upload modified parameter files or change parameter file assignments, you must reload the
PowerCenter resource. Metadata Manager can then use the updated parameter file assignments to display
data lineage.
116 Chapter 7: Data Integration Resources
Parameter File Requirements
To enable Metadata Manager to read parameter values from a parameter file, the file must have a .txt, .prm,
or .par extension.
You group parameters and variables in different sections of the parameter file. Each section is preceded by a
heading that identifies the folder, workflow, worklet, and session to which you want to pass parameter or
variable values. You define parameters and variables directly below the heading, entering each parameter or
variable on a new line.
The following table describes the headings that define each section in the parameter file and the scope of the
parameters and variables that you define in each section:
Heading Scope
[Global] All folders, workflows, worklets, and sessions.
[folder name.WF:workflow name] The named workflow and all sessions within the workflow.
[folder name.WF:workflow name.WT:worklet name] The named worklet and all sessions within the worklet.
[folder name.WF:workflow name.WT:worklet
name.WT:worklet name...]
The nested worklet and all sessions within the nested worklet.
[folder name.WF:workflow name.ST:session name]
-or-
[folder name.WF:workflow name.WT:worklet
name.ST:session name]
-or-
[folder name.WF:workflow name.WT:worklet
name.WT:worklet name.ST:session name]
-or-
[folder name.session name]
-or-
[session name]
The named session.
Ignored Information in Parameter Files
Metadata Manager ignores the following information in the parameter files:
Service parameters. Metadata Manager does not extract service parameters.
Sessions or workflows without parameters. Metadata Manager does not require all sessions or
workflows to use parameter files.
Duplicate sessions. Metadata Manager extracts the parameter for the first occurrence of the session. If
you use a reusable session multiple times, the parameter file must identify each session instance.
Duplicate headings. If the parameter file specifies the same heading multiple times, Metadata Manager
uses the information in the section below the first heading. Metadata Manager ignores the information in
the sections below subsequent identical headings.
Invalid parameter and value pair format. The parameter and value must be entered on a single line in
the form name=value.
PowerCenter Resources 117
Rules and Guidelines for Parameter Files
Metadata Manager uses the following guidelines to read the parameter files:
If you define the same parameter or variable in multiple sections in the parameter file, the parameter or
variable with the smallest scope takes precedence over parameters or variables with larger scope. For
example, a parameter file contains the following sections:
[HET_TGTS.WF:wf_TGTS_ASC_ORDR]
$DBConnection_ora=Ora2
[HET_TGTS.WF:wf_TGTS_ASC_ORDR.ST:s_TGTS_ASC_ORDR]
$DBConnection_ora=Ora3
In session s_TGTS_ASC_ORDR, the value for session parameter $DBConnection_ora is “Ora3.” In all
other sessions in the workflow, it is “Ora2.”
If a mapping parameter is not assigned a value in the parameter file, Metadata Manager uses the default
value of the parameter in the mapping.
If a parameter value that contains single-byte characters exceeds 4000 characters, Metadata Manager
truncates the value to 4000 characters. If a parameter value that contains multibyte characters exceeds
2000 characters, Metadata Manager truncates the value to 2000 characters.
Metadata Manager cannot read a parameter file that is assigned to a PowerCenter folder with a name that
contains the following special characters:
. + - = ~ ` ! % ^ & * () [] {} ' \ " ; : / ? , < > \\ | \t \r \n
Sample Parameter File
The following example shows a sample connection parameter file entry:
[CustomerInformation.WF:WF_DB_CATALOG_ORCL.ST:S_M_ELMNT_ASSOC_EXTRACT]
$$WEIRD_CHAR=~!@#$%^&*()_+|{}[]=:";'<>?,./`
$DBConnection_source=customer_source_DB
$DBCONNECTION_SOURCE=hello
$DBConnection_target=customer_target_DB
$DBConnection_SARAH=sarah
$DBCONNECTION_WEED=weedy
$PMSessionLogFile=$PMRootDir/sessionname1.log
Uploading Parameter Files
Upload the PowerCenter parameter files to the node running the Metadata Manager application.
To upload parameter files:
1. On the Load tab, select the PowerCenter resource in the Resources panel.
2. In the Properties panel, click Edit.
The Edit Resources window appears.
3. Click the Parameter Files tab.
4. Click Upload.
The Upload dialog box appears.
5. Click Browse to select one or more parameter files.
6. Click Open.
If you select the same file multiple times, the most recently selected file overwrites the earlier version.
7. To remove any selected files, click Remove.
8. To upload the selected files, click Upload.
118 Chapter 7: Data Integration Resources
You can upload multiple parameter files at the same time. The Upload dialog box displays the upload
status of each file.
9. Click Close.
10. To remove an uploaded parameter file, select the file in the Parameter Files list and click Delete.
Assign the uploaded parameter files to PowerCenter workflows.
Assigning Parameter Files to PowerCenter Workflows
After you upload parameter files, assign the files to PowerCenter workflows. You cannot assign parameter
files to individual PowerCenter sources, targets, or lookups. You assign parameter files to the workflow that
contains the sources, targets, and lookups.
1. On the Load tab, select the PowerCenter resource in the Resources panel.
2. In the Properties panel, click Edit.
The Edit Resources window appears.
3. Click the Parameter Files tab.
4. Perform one of the following tasks to assign parameter files:
To direct Metadata Manager to analyze the PowerCenter repository and assign the uploaded
parameter files to each workflow that specifies the parameter file name, click Auto-assign.
To assign parameter files individually, select a parameter file in the Parameter Files list, select one
or more folders or workflows in the Workflow Folders list, and click Assign.
To assign a parameter file to all workflows, select the parameter file and click Assign to All.
Note: When you configure a PowerCenter workflow, if you use an absolute file name or the
$PMFolderName and $PMWorkflowName workflow variables to specify the parameter file name,
Metadata Manager uses this value to automatically assign the parameter file to the workflow. If you use
any other workflow variable for configuring the parameter file name, you must assign the parameter file
to the workflow manually.
5. To remove a parameter file from a workflow, click Remove for the parameter file in the bottom panel.
6. Click OK.
After you change parameter file assignments, you must reload the PowerCenter resource. Metadata Manager
can then process the updated parameter file assignments to update links between resources to correctly
display data lineage.
Tip: When you save a PowerCenter resource, the Metadata Manager service log lists workflows that have no
assigned parameter file. To view the Metadata Manager service log, select Help > Export Service Log.
Reference
After you create and load a PowerCenter resource, you can view and run data lineage on the metadata
objects that PowerCenter extracted.
Incremental Extracts
Metadata Manager supports incremental extractions from the PowerCenter repositories.
By default, Metadata Manager can extract metadata incrementally. Metadata Manager initially extracts
metadata from the previous 8,000 days, which is longer than 20 years. After the first metadata load, decrease
the time period to extract metadata that has been added, modified, or deleted recently. You do not need to
reload unchanged metadata.
PowerCenter Resources 119
Metadata Object Properties
Metadata Manager extracts properties of PowerCenter metadata objects and stores their values in the
Metadata Manager warehouse.
Metadata Manager truncates the value of an object property if the value is stored in multiple records.
Metadata Manager extracts the value from the first record only. For example, a PowerCenter repository
resides on an IBM DB2 for LUW database. The PowerCenter repository contains an SQL override that is
5,000 characters long.
When you create the SQL override in PowerCenter, PowerCenter stores the SQL override metadata in three
records in an IBM DB2 for LUW database table. Since the IBM DB2 for LUW database can store up to 2,000
characters for each field, PowerCenter splits the 5,000-character SQL override metadata among three
records. The first record contains the first 2,000 characters, the second record contains the next 2,000
characters, and the third record contains 1,000 characters.
Since Metadata Manager only extracts the first record for any object property, Metadata Manager only
extracts the first 2,000 characters of SQL override metadata from the IBM DB2 for LUW database table.
The following table provides the maximum number of characters extracted for a PowerCenter metadata
object property contained in the given database:
Database Maximum Characters Extracted
IBM DB2 for LUW 2,000 characters
Microsoft SQL Server 4,000 characters
Oracle 2,000 characters
Sybase 4,000 characters
Record Filters and Rejects
While loading PowerCenter sessions into the Metadata Manager warehouse, Metadata Manager rejects or
filters the records if it cannot resolve their corresponding database columns.
Metadata Manager filters records that meet any of the following conditions:
The session instance connection is not assigned to a database schema.
The connection assignment is valid, Metadata Manager cannot resolve the database column, and an SQL
override exists on the reader transformation, such as Lookup or Source Qualifier transformation.
Metadata Manager rejects records that meet any of the following conditions:
The session instance connection is assigned to a schema, the Source Qualifier transformation does not
have an SQL override, and Metadata Manager cannot resolve the database columns.
Metadata Manager cannot resolve the PowerCenter target structure and the corresponding database
columns.
Scope for Data Lineage
Metadata Manager supports data lineage for the following objects:
Local shortcuts, not global shortcuts
Relational connections, not application connections
Lookup transformations and source instances
120 Chapter 7: Data Integration Resources
Structure-level lineage for each transformation
Connected and unconnected transformations
SQL Inline Views
An SQL inline view is a SELECT statement in the FROM clause of another SELECT statement. For example,
the following SQL includes an inline view:
SELECT ename
FROM (SELECT ename
FROM emp)
A PowerCenter Source Qualifier or Lookup transformation can include an SQL override that refers to a
database table, view, or synonym in an inline view. If you create connection assignments between the
relational database and PowerCenter resources, data lineage for the database table, view, or synonym
displays the links between the relational database objects and the PowerCenter transformations.
Note: SQL inline views are also referred to as Common Table Expressions.
Case Sensitivity
PowerCenter does not indicate if connections and databases are case sensitive. Metadata Manager assumes
that the database storing the PowerCenter metadata is not case sensitive. Metadata Manager stores the
structure name and property name in uppercase letters.
Flat Files
PowerCenter can use flat files as sources, targets, and lookups in mappings. Metadata Manager displays the
following types of flat files from a PowerCenter source repository in the metadata catalog:
XML
VSAM
Delimited
Fixed-width
In PowerCenter, you can assign an Integration Service to run the workflow. The metadata catalog displays
flat file sources and targets from a PowerCenter repository under the corresponding Integration Service. If the
flat file is located in a repository with no Integration Service configured, the metadata catalog displays the flat
file under the object called “Unknown Service.”
Metadata Manager displays field-level details in data lineage for columns in delimited and fixed-width flat
files. Metadata Manager determines the columns in the delimited and fixed-width flat files using source and
target definitions in PowerCenter. Since XML and VSAM flat files do not contain columns, Metadata Manager
does not display field-level details in data lineage for these flat file types.
Command Tasks
A PowerCenter Command task can include multiple commands. Each command can be named or unnamed.
The metadata catalog lists any unnamed command with the name "CommandLineTask<number>" where
<number> represents the order of the unnamed command in the Command task.
For example, a Command task includes one command named "FirstCommand" and two unnamed
commands. The metadata catalog lists the commands with the following names:
FirstCommand
CommandLineTask1
PowerCenter Resources 121
CommandLineTask2
Unique Constraint Errors
When you load a PowerCenter resource, the S_M_ELMNT_ATTR_EXTRACT session can reject rows due to
unique key constraint errors. The PowerCenter SourceDefinition object contains duplicate attribute names.
For example, it contains duplicate Tree Name, Set ID, Effective Date, and Set Control Value attributes for the
SourceDefinition object. Metadata Manager extracts only one of the values.
Mapplets
If you launch data lineage on a mapplet port for a mapplet that does not have any instances in PowerCenter
mappings, Metadata Manager displays the mapplet and the mapplet ports in the data lineage diagram.
Metadata Manager does not display links from the mapplet ports to other PowerCenter objects. If you launch
lineage on a mapplet port, and the mapplet has instances in PowerCenter mappings, Metadata Manager
displays the links from the mapplet input and output ports to the other PowerCenter objects.
122 Chapter 7: Data Integration Resources
CHAPTER 8
Data Modeling Resources
This chapter includes the following topics:
Embarcadero ERStudio, 123
ERwin, 129
SAP PowerDesigner, 140
Adding or Removing Metadata Files for a Resource, 143
Reference for Data Modeling Resources, 144
Embarcadero ERStudio
Embarcadero ERStudio is a data modeling tool used to create and maintain data models.
You can create and configure an Embarcadero ERStudio resource to extract Embarcadero ERStudio
metadata. Metadata Manager extracts Embarcadero ERStudio logical and physical models from a metadata
file. Before you create an Embarcadero ERStudio resource, you export Embarcadero ERStudio models to
metadata files. When you create the resource, you specify the metadata file.
Configuring Embarcadero ERStudio
Before you create an Embarcadero ERStudio resource, you must configure the metadata source. If you do
not correctly configure the metadata source, the metadata load can fail or the metadata can be incorrectly
loaded in the Metadata Manager warehouse.
To configure Embarcadero ERStudio, complete the following tasks:
Install the Metadata Manager Agent.
Export models to metadata files.
Install the Metadata Manager Agent
The Metadata Manager Agent is a Windows-based program that Metadata Manager uses to access metadata
sources and extract source metadata. By default, the Metadata Manager Agent runs on the Windows nodes
where the Metadata Manager Service runs.
To extract metadata from Embarcadero ERStudio, you must install the Metadata Manager Agent separately
on a Windows machine. The Metadata Manager Agent and Embarcadero ER/Studio Data Architect must be
on the same machine.
123
Related Topics:
“Step 2. Install the Metadata Manager Agent” on page 22
Export Models to Metadata Files
To extract metadata from Embarcadero ERStudio, you export models from Embarcadero ERStudio to
metadata files. Metadata Manager extracts the models from the exported metadata files.
Metadata Manager extracts physical and logical models that are set to Relational notation. Before you export
metadata, use the ERStudio client tool to set the physical and logical models that you want to extract to
Relational notation.
Use the ERStudio client tool to export the metadata to a .dm1 file. The file can contain one logical model and
any number of physical models. Metadata Manager extracts the logical model and the physical model that is
created from the logical model. Metadata Manager displays all objects extracted from logical and physical
models under the logical model.
Creating an Embarcadero ERStudio Resource
Before you create an Embarcadero ERStudio resource, export the Embarcadero ERStudio models to
metadata files.
1. On the Load tab, click Actions > New Resource.
The Resource Selection window appears.
2. Click Data Modeling > Embarcadero ERStudio.
3. Click Next.
The Properties page appears.
4. Enter the following information:
Property Description
Name Name for the resource. The resource appears in the Resources panel with this name. The name
must be unique and have from one through 256 characters. It cannot include the following characters:
/ \ : * ' ? " < > | [ ]
Description Description for the resource. Description cannot exceed 4000 characters.
Hide in Summary
Lineage
Hides the resource in the summary view of data lineage diagrams.
Enable this option to hide the resource and its child objects in the summary view. Disable this option
to display the resource and its child objects in the summary view.
Default is disabled.
5. Click Next.
The Configuration page appears.
6. Enter the configuration properties.
7. Click Test Connection to validate the source file configuration.
Metadata Manager validates the Metadata Manager Agent URL. If you configured Metadata Manager to
use the latest source file, Metadata Manager also validates that the source file exists in the specified
path.
124 Chapter 8: Data Modeling Resources
If Metadata Manager cannot validate the source file configuration, an error message appears. Correct
any error and test the connection again.
8. Click Next.
The Schedules page appears.
9. To add a schedule, select Attach a Schedule and select a schedule in the Schedule list.
If you have not created a schedule, you can assign a schedule to a resource after you create the
resource.
10. Click Finish.
The resource appears in the Resources panel on the Load tab.
Embarcadero ERStudio Configuration Properties
Update the configuration properties when you create or edit an Embarcadero ERStudio resource.
The following table describes the configuration properties:
Property Description
Agent URL Host name and port number of the Metadata Manager Agent. You can use the Metadata Manager Agent
installed on any machine.
Source system
version
Name and version of the resource.
Always use latest
source files
Metadata Manager uses the metadata source file in the location you provide each time you load the
resource. If you enable this option, the path to the file must include an absolute path that is accessible
from the Metadata Manager Agent machine. If you disable this option, Metadata Manager copies the
metadata source file to the Metadata Manager application directory when you finish configuring the
resource. Each time you load the resource, Metadata Manager uses the copied metadata source file in the
Metadata Manager application directory.
Model selection Type of model from which metadata is extracted. DM1 files have multiple independent models.
Select one of the following options:
-Logical model. Select this option to extract metadata from logical models.
-Physical model. Select for physical models and when the DM1 file has a combination of physical and
logical models. You must specify the name of the model.
-All models. Select this option to extract metadata from logical and physical models.
Default is Logical model.
Physical model
name
Name of the physical model from which you want to extract metadata.
Skip UDP
extraction
Prevents Metadata Manager from importing attachments, also called user-defined properties (UDPs), from
ERStudio. If you enable this option, Metadata Manager does not import UDPs and does not display the
Import UDPs property. Default is disabled.
Embarcadero ERStudio 125
Property Description
Import UDPs Defines how Metadata Manager imports attachments, also called user-defined properties (UDPs), from
ERStudio. An attachment usually has a default value. The objects bound to the attachment can override it
with an explicit value or reuse the default value.
Select one of the following options to specify how to import property definitions and values:
-As metadata. Imports explicit values as Property Value objects. Default values are not imported. This
option keeps the default value on the Property Type.
-As metadata, migrate default values. Imports explicit and default values as Property Value objects.
-In description, migrate default values. Appends the property name and value to the object description
property for both explicit and implicit values.
-Both, migrate default values. Imports the UDP value as metadata and in the object description property.
Default is as metadata.
Import owner
schemas
Imports owner schemas. Select one of the following options:
-True. Imports owner schemas for tables, views, and other database objects. Select for physical models
and when the DM1 file has a combination of physical and logical models.
-False. Ignores owner schemas for tables, views, and other database objects. Select for logical models.
Default is true.
Auto assign
connections
Metadata Manager configures connection assignments to relational database resource types during the
resource load. If you disable this option, configure connection assignments in the resource properties after
you create the resource.
File The DM1 file that you want to import.
Reference
After you create and load an ERStudio resource, you can view and run data lineage on the metadata objects
that Metadata Manager extracted.
Objects Extracted
The following table lists the physical / logical objects that Metadata Manager extracts from Embarcadero
ERStudio:
AliasClassifier
Attachment
AttachmentType
Attribute
BufferPool
CandidateKey
Categorization
Column
Connection
ConnectionSchema
Constraint
Database
DatabaseInstance
126 Chapter 8: Data Modeling Resources
DataFlow
DataMappingModel
Default
DiagramContent
DiagramFolder
Domain
Entity
ER_Studio
FileDirectory
FlatFileModel
FlatFileSource
Folder
ForeignKey
IdentifyingRelationship
Identity
Index
IndexMember
InputTable
LogicalDataModel
LogicalDiagram
LogicalModel
LogicalRule
LogicalSource
LogicalSubmodel
MainLogicalModel
MainPhysicalModel
MappingDataAttribute
NonIdentifyingRelationship
NonSpecificRelationship
Note
OtherSource
OutputTable
Parameter
Partition
PhysicalDataModel
PhysicalDiagram
PhysicalExtension
PhysicalModel
PhysicalObject
Embarcadero ERStudio 127
PhysicalRule
PhysicalSource
PhysicalSubmodel
PrimaryKey
PrimaryKeyAttribute
PrimaryKeyColumn
Project
ReferenceValueList
Reference Value Range
RelationshipEnd1
RelationshipEnd2
Repository
Schema
Sequence
Shape
SourceTable
StorageGroup
StoredProcedure
SuperTypeRelationship
Synonym
SynonymColumn
Table
TableSpace
Transformation
Trigger
View
TypeValue
UserDatatype
View
ViewColumn
ViewRelationship
Volume
XmlSchema
128 Chapter 8: Data Modeling Resources
ERwin
ERwin is a tool that you use to create and maintain logical or physical data models of relational databases. In
Metadata Manager, you can create and configure an ERwin resource to extract and represent metadata from
data models in ERwin.
Metadata Manager can extract ERwin metadata through the following sources:
Source repository
Metadata Manager connects to the ERwin Data Modeler repository to extract metadata.
Source file
Metadata Manager extracts ERwin metadata from a metadata file that was previously exported from
ERwin.
Configuring ERwin
Before you create an ERwin resource, you must configure the metadata source. If you do not correctly
configure the metadata source, the metadata load can fail or the metadata can be incorrectly loaded in the
Metadata Manager warehouse.
To configure ERwin, complete the following tasks:
Install the Metadata Manager Agent.
Enable the Metadata Manager Agent to interact with desktop for ERwin 7.x, 8.x, and 9.x.
Export models to metadata files.
Install the Metadata Manager Agent
The Metadata Manager Agent is a Windows-based program that Metadata Manager uses to access metadata
sources and extract source metadata. By default, the Metadata Manager Agent runs on the Windows nodes
where the Metadata Manager Service runs.
Install the Metadata Manager Agent separately on a Windows machine when ERwin is not on the same
machine as the Metadata Manager Service.
The Metadata Manager Agent has the following installation requirements based on the ERwin source type:
ERwin repository format XML file or ERwin source file
You can use the Metadata Manager Agent installed on any machine. If you configure Metadata Manager
to use the latest source files, the location of the source files must be accessible from the Metadata
Manager Agent machine.