7/25/2019 Mdm Console 71
1/365
SAP AG Neurottstrasse 16 69190 Walldorf Germany +49 6227 74 74 74 fax +49 6227 75 75 75
SAP NetWeaverMaster Data Management (MDM)
MDM Console
Reference Guide
Release: MDM 7.1 SP08
April 3, 2012
7/25/2019 Mdm Console 71
2/365
ii MDM Console Reference Guide
Copyright 2001-2012 SAP AG. All rights reserved.
No part of this publication may be reproduced or transmitted in any form or for any purposewithout the express permission of SAP AG. The information contained herein may bechanged without prior notice.
Some software products marketed by SAP AG and its distributors contain proprietarysoftware components of other software vendors.
Microsoft, Windows, Excel and Access are registered trademarks of Microsoft Corporation.
IBM, DB2 and DB2 Universal Database are trademarks or registered trademarks of IBMCorporation in the United States and/or other countries.
Oracle is a registered trademark of Oracle Corporation.
HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C, WorldWide Web Consortium, Massachusetts Institute of Technology.
Java is a registered trademark of Sun Microsystems, Inc. JavaScript is a registeredtrademark of Sun Microsystems, Inc., used under license for technology invented andimplemented by Netscape.
The Sentry Spelling-Checker Engine Copyright 1994-2004 Wintertree Software Inc. Allrights reserved.
SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP NetWeaver and other SAP products andservices mentioned herein as well as their respective logos are trademarks or registeredtrademarks of SAP AG in Germany and in several other countries all over the world. All otherproduct and service names mentioned are the trademarks of their respective companies.Data contained in this document serves informational purposes only. National productspecifications may vary.
These materials are subject to change without notice. These materials are provided by SAPAG and its affiliated companies (SAP Group) for informational purposes only, withoutrepresentation or warranty of any kind, and SAP Group shall not be liable for errors oromissions with respect to the materials. The only warranties for SAP Group products andservices are those that are set forth in the express warranty statements accompanying suchproducts and services, if any. Nothing herein should be construed as constituting an
additional warranty.
09 08 07 9 8 7 6 5 4 3 2 1
SAP AGNeurottstrasse 16
69190 WalldorfGermany+49 6227 74 74 74 tel+49 6227 75 75 75 [email protected] emailhttp://www.sap.com web
Printed in the United States of America.
7/25/2019 Mdm Console 71
3/365
MDM Console Reference Guide iii
Contents
Part 1: Basic Concepts ............................................................ 13
What is a Master Data Server? ........................................................ 15MDM Auxiliary Servers................................................................. 16
What is an MDM Repository? .......................................................... 17MDM Repository Structure ........................................................... 18Taxonomies ................................................................................. 20
Attributes ...................................................................................... 21
Qualified Tables and Qualifiers .................................................... 22Product Applications and Application-Based Search ................... 22
Product Families .......................................................................... 23Product Masks ............................................................................. 24
Data Groups ................................................................................. 25
Validations and Validation Groups ............................................... 25Data Quality and MDM ................................................................. 26
Part 2: Starting MDM Console ................................................ 27
Starting and Exiting MDM Console .................................................. 29
MDM Console Settings File .......................................................... 30Command Line Arguments .......................................................... 32
MDM Console Main Window ............................................................ 33
Console Hierarchy Pane .............................................................. 33Objects Pane ............................................................................... 34
Object Detail Pane ....................................................................... 35Functions Tab .............................................................................. 35Tables and Fields Tab.................................................................. 36
Status Bar .................................................................................... 36Configuration Parameters ................................................................ 37
Console Settings .......................................................................... 37Master Data Server Settings ........................................................ 37
MDM Auxiliary Server Settings .................................................... 37Repository Properties................................................................... 37
DBMS Settings ............................................................................. 37
Part 3: MDM System Access................................................... 39
Accessing MDM Repositories .......................................................... 41
DBMS Servers ..................................................................................... 42
Repository Port Numbers ..................................................................... 42Accessing an MDM Repository .................................................... 43
Mounting and Unmounting an MDM Repository ................................... 45Connecting to and Disconnecting from an MDM Repository ................ 46Loading and Unloading an MDM Repository ........................................ 47
7/25/2019 Mdm Console 71
4/365
iv MDM Console Reference Guide
Part 4: Repository Design ....................................................... 51
Planning the MDM Repository .......................................................... 53
MDM 7.1 Metamodel Enhancements ............................................... 54MDM Table Types ............................................................................ 55
Main Tables .................................................................................. 57Multiple Main Tables ............................................................................ 58Lookup [Main] Field Type ..................................................................... 59
Flat and Hierarchy Lookup Tables ................................................ 60
Taxonomy Lookup Tables ............................................................ 60Qualified Lookup Tables ............................................................... 61
Multiple Prices and Cross-Reference Part Numbers ............................. 62Product Applications and Application-Based Search ............................ 66
Valid Tables and Nested Lookups-within-Lookups ....................... 69Lookup and Non-Lookup Subtables A Comparison ................... 70
Object Tables ............................................................................... 72
Special Tables .............................................................................. 73Image Variants Table ................................................................... 74
Configuring the Watermark .................................................................. 80Families Table .............................................................................. 81
Relationships Table ...................................................................... 82Relationship Types ............................................................................... 83Sibling vs. Parent/Child Relationships .................................................. 84
Single- vs. Multi-Table Relationships .................................................... 85Single- vs. Multi-Level Relationships .................................................... 86
Hybrid Relationships ............................................................................ 86Relationship Qualifiers ......................................................................... 87
MDM Data Types .............................................................................. 88
Dimensions and Units .......................................................................... 90Fields vs. Attributes A Comparison ............................................ 90
MDM Tuples ..................................................................................... 92What is a Tuple? ........................................................................... 93
Tuples and Tables ........................................................................ 93Single-Valued Tuple Fields .................................................................. 94
Multi-Valued Tuple Fields ..................................................................... 94Tuples as Custom Composite Data Types ................................... 95Tuples and Existing MDM Structures ........................................... 95
Qualified Lookups ................................................................................ 96Parent/Child Relationships ................................................................... 96Hierarchical Main Table Entities ........................................................... 97
Tuples and XML ........................................................................... 98
Tuples and Multi-Table Relationships ........................................... 98Tuples and Nested Structures ...................................................... 99
Sharing Tuple Subrecords .......................................................... 100
Tuples and the Relational Model ................................................ 100Tuple Terminology ...................................................................... 101
Supported Field Types ............................................................... 101Tuple Workflow ........................................................................... 102
7/25/2019 Mdm Console 71
5/365
MDM Console Reference Guide v
Part 5: Repository Maintenance ........................................... 103
Working with MDM Repositories .................................................... 105
Creating an MDM Repository ..................................................... 105Setting Number of Repository Partitions .................................... 110
Repository Partitions .......................................................................... 110Modifying Repository Properties ................................................ 112
Photoshop and Photoshop Image Processing.................................... 114Using CSV Format to Import Delimited Text Files .............................. 114
Deleting an MDM Repository ..................................................... 115Working with Tables and Fields ..................................................... 117
The Code Property ..................................................................... 117
Working with Tables ....................................................................... 119
Table Properties ......................................................................... 119
Display Fields .................................................................................... 120Unique Fields .................................................................................... 123Display Fields, Unique Fields, and Record Operations ...................... 125Family Field ....................................................................................... 126Alternative Display Fields ................................................................... 127
Adding and Deleting Tables ....................................................... 128Deleting Tables .......................................................................... 128
Working with Fields ........................................................................ 129Field Properties .......................................................................... 129
Required Fields ................................................................................. 132
Normalized Fields .............................................................................. 132Sort-Indexed Fields............................................................................ 132Sort Types ......................................................................................... 133Keyword Fields .................................................................................. 134Caching Qualifiers ............................................................................. 135Decimals, Fractions, and Floating Point Precision ............................. 135Show Fractions .................................................................................. 136Calculation Fields .............................................................................. 137Create Stamp, Time Stamp, and User Stamp Fields .......................... 138
Adding and Modifying Fields ...................................................... 139
Reordering Fields ....................................................................... 140
Deleting Fields ........................................................................... 141Working with Tuples ....................................................................... 142
Tuple Properties ......................................................................... 142Adding and Deleting Tuples ....................................................... 142Working with Tuple Member Fields ............................................ 143
Adding and Deleting Tuple Member Fields ........................................ 143Reordering Tuple Member Fields ....................................................... 144
Part 6: Repository Administration ....................................... 145
Repository Administration Operations ............................................ 147
Appropriating an MDM Repository ................................................. 148Updating an MDM Repository ........................................................ 149Verifying an MDM Repository ........................................................ 150
7/25/2019 Mdm Console 71
6/365
vi MDM Console Reference Guide
Duplicating an MDM Repository ..................................................... 152Maintaining Master and Slave Repositories ................................... 157
Master/Slave Landscapes .......................................................... 157Master/Slave Limitations............................................................. 159
Moving Master and Slave Repositories .............................................. 159Synchronization Requires Identical MDS Versions ............................. 159Syndication Tracking Information is not Synchronized ........................ 159
Identifying Master and Slave Repositories.................................. 160Publication Slaves ...................................................................... 160
Master/Slave-Related Operations ............................................... 161Creating Master and Slave Repositories .................................... 161
Configuring Master/Slave Repositories for SSL .......................... 164
Synchronizing a Slave Repository .............................................. 164
Broken Master/Slave Repositories ............................................. 166
Normalizing a Master or Slave Repository.................................. 167Backing Up and Restoring a Repository ......................................... 168
MDM Repository Archive and Unarchive .................................... 170
Archiving an MDM Repository ............................................................ 171Archive Options Dialog ....................................................................... 173Unarchiving an MDM Repository Over Another Repository ................ 174Archive Report ................................................................................... 175Managing Archive Files ...................................................................... 175Dealing with Outdated Archives ......................................................... 175
MDM Publication Model Archive and Unarchive ......................... 176
Exporting and Importing Schemas .................................................. 178
Exporting an MDM Repository Schema ...................................... 180Importing an MDM Repository Schema ...................................... 181
Import Schema Dialog at a Glance ..................................................... 181Color Coding in the Import Schema Dialog ......................................... 182Comments ......................................................................................... 183Importing the Schema ........................................................................ 183Manually Overriding Schema Reconciliation....................................... 185
MDM Transport Operations ............................................................ 186
SchemaMigration ....................................................................... 186Commands ........................................................................................ 186Files ................................................................................................... 186
CTS+ .......................................................................................... 186Commands ........................................................................................ 186Files ................................................................................................... 187Errors ................................................................................................. 188
Schema Transport versus CTS+ ................................................ 188
Part 7: MDS Administration .................................................. 189
Accessing Master Data Servers ..................................................... 191Accessing a Master Data Server ................................................ 191
Mounting and Unmounting the Master Data Server ............................ 192Starting and Stopping Master Data Servers ............................... 193
Monitoring Master Data Server Activity .......................................... 195
7/25/2019 Mdm Console 71
7/365
MDM Console Reference Guide vii
The MDM Console Activities Pane ............................................. 195CLIX Activity Monitoring Commands .......................................... 196
Optimizing MDS Performance ........................................................ 199What is Slicing? ......................................................................... 199
Bulk and Non-Bulk Operations ................................................... 200
Configuring Slicing for Bulk Operations .............................................. 201Configuring Slicing for Non-Bulk Operations ...................................... 201
Slicing and Failure Handling ...................................................... 203Slicing and Import ...................................................................... 203
MDIS Chunk Size .............................................................................. 203Record Checkouts ............................................................................. 203Workflows .......................................................................................... 203
Optimizing MDM Client Performance ............................................. 205Notification Filtering ................................................................... 205
Object Cache Size Registry Setting ........................................... 205
Logs, Traces, and Reports ............................................................. 206Logs ........................................................................................... 206
Log File Types ................................................................................... 206Viewing Log Files .............................................................................. 206Log Message Severities .................................................................... 207Configuring Log Size and Rotation Parameters ................................. 207
Traces ........................................................................................ 208
Trace Message Severities ................................................................. 208
Filtering Logging of MDS-Related Trace Messages ........................... 208
Filtering Logging of Auxiliary MDM Server Trace Messages .............. 209Performance Tracing.................................................................. 209
Turning Performance Tracing On or Off ............................................. 210Configuration File Parameters for Performance Tracing .................... 210
Reports ...................................................................................... 211
Report Types ..................................................................................... 211Viewing Reports ................................................................................ 211
MDS Configuration ......................................................................... 212
Master Data Server Parameters ................................................ 212
MDM Repository Parameters ..................................................... 221
SSL-Related Parameters for a Client MDS ................................ 223
DBMS Settings ............................................................................... 224DBMS Initialization ..................................................................... 226
MDM DBMS Server Account ...................................................... 227Multiple DBMS Instances ........................................................... 228DBMS Servers List ..................................................................... 228
Part 8: MDIS Administrat ion ................................................. 231
The Master Data Import Server ...................................................... 233MDIS vs. The Import Manager ................................................... 233What is Streaming? .................................................................... 235
Ports and MDIS .......................................................................... 235Port Requirements ............................................................................. 235
7/25/2019 Mdm Console 71
8/365
viii MDM Console Reference Guide
Import File Location ............................................................................ 236Real-Time Port Processing ................................................................ 236File Aggregation ................................................................................. 237
Port Status ......................................................................................... 237
File Formats Compatible With MDIS .......................................... 238
Text Formats ...................................................................................... 238Simple vs. Complex XML ................................................................... 239
Solutions for Other XML Formats ............................................... 239XML Files That Split Information Between Header and Body .............. 240SAP R/3 MATMAS XML Files ............................................................ 241
Virtual Extended Records ........................................................... 242Using MDIS .................................................................................... 244
MDIS Checklist ........................................................................... 244
Monitoring Import Status From The MDM Console .................... 245Exception Handling ......................................................................... 246
What Happens When Exceptions Occur?................................... 246Structural Exceptions ......................................................................... 246Value and Import Exceptions .............................................................. 246Port Blocking ...................................................................................... 246
Exception Folders ....................................................................... 247
How Do You Fix Exceptions? ................................................... 247MDIS Configuration ........................................................................ 248
Global mdis.ini parameters ......................................................... 248Repository-Specific mdis.ini parameters .................................... 250
SSL-Related mdis.ini Parameters ............................................... 251
Configuring MDIS from MDM Console ....................................... 252Optimizing MDIS Performance ................................................... 252
Troubleshooting .............................................................................. 254Import Files Are Not Being Processed by MDIS ......................... 254
Checking Server and Repository Status ............................................. 254Checking for Port Problems................................................................ 254Checking MDIS Configuration Settings ............................................... 255
Checking for Source File Problems (Structural Exceptions) ................ 255
Checking for Source File Problems (Incomplete Files) ....................... 256
Port Has Exceptions ................................................................... 256
Source Fields or Values Not Being Imported .............................. 256Source File is Too Large to Open in Import Manager ................. 257
Enabling Tracing and Audit Trails in the Import Log ................... 257
Part 9: MDSS Administration................................................ 259
The Master Data Syndication Server .............................................. 261
MDSS vs. Syndicator .................................................................. 261
Ports and MDSS ......................................................................... 262
Syndication File Location ................................................................... 262Multi-Threaded Port Processing ......................................................... 263
Using MDSS ................................................................................... 264MDSS Checklist .......................................................................... 264
7/25/2019 Mdm Console 71
9/365
MDM Console Reference Guide ix
Scheduling Syndications to a Port ............................................. 265Monitoring Syndication Status from MDM Console ....................... 266
MDSS Configuration ...................................................................... 267Global mdss.ini Parameters ....................................................... 267
Repository-Specific mdss.ini Parameters................................... 269
SSL-Related mdss.ini Parameters ............................................ 269Configuring MDSS from MDM Console...................................... 270
Troubleshooting ............................................................................. 272
Syndications Are Not Being Executed By MDSS ....................... 272Verifying Server and Repository Status ............................................. 272Checking Port Settings ...................................................................... 272Checking Map Properties and Search Selections .............................. 273
Checking MDSS Credentials ............................................................. 273
Scheduled Syndications Arent Executed On Time .................... 274
Unchanged Records Are Not Being Suppressed ....................... 274Changed Records Are Not Being Syndicated .......................... 275
Syndication File Is Too Big For MDSS ....................................... 275Record Data Changes During Syndication................................. 275
Part 10: MDM System Administration .................................. 277
MDM Security Overview................................................................. 278
Master Data Server Security ...................................................... 279MDM Repository Security .......................................................... 280
MDM User and Role Management ................................................. 282Users Table ................................................................................ 282Roles Table ................................................................................ 283
Functional Privileges .......................................................................... 284Table and Field Privileges .................................................................. 289Record Constraints ............................................................................ 291Performing MDM Operations ............................................................. 294
Connections Table ..................................................................... 295
LDAP Support ............................................................................ 295Trusted Connections .................................................................. 295
Additional MDM Tables .................................................................. 296
Workflows Table ........................................................................ 296Change Tracking Table .............................................................. 296Links Table ................................................................................. 298
URL Syntax ....................................................................................... 299XML Schemas Table .................................................................. 300
Part 11: Multi lingual Support ................................................ 301Introduction .................................................................................... 303
Multi-Byte Unicode Implementation ........................................... 303
Multi-Layered Data Model .......................................................... 304Language-Centric Views ............................................................ 304
Multilingual Repository Metadata ............................................... 304
7/25/2019 Mdm Console 71
10/365
x MDM Console Reference Guide
Multilingual Repository Data ....................................................... 305Multilingual Publishing ................................................................ 305
Multilingual GUI Software ........................................................... 305
Repository Languages and Language Names............................ 305Multilingual Data and Metadata Elements .................................. 305
Multilingual Basics .......................................................................... 307Language Layers ........................................................................ 307
Language Inheritance ................................................................. 308
Inheritance Levels ...................................................................... 311Quick Reference ............................................................................. 312
Multilingual Operations ................................................................... 314
Modifying the Repository Languages ......................................... 315
Changing the Display Name of a Repository Language ............. 317Modifying Language-Specific Language Inheritance .................. 318
Defining Multilingual Table Names ............................................. 319Defining Multilingual Field Names .............................................. 320
Defining Multilingual Fields ......................................................... 321MDM Language Selector Tool ........................................................ 322
Part 12: Remote Systems and MDM .................................... 323
Remote Systems and MDM ............................................................ 325
What is a Remote System? ........................................................ 325
Key Mapping ............................................................................... 325
Remote Systems Table .............................................................. 326
[Remote System]and [Remote Key]Fields ................................ 327Remote System Semantics ........................................................ 328
Ports and MDM ............................................................................... 329What is a Port? ........................................................................... 329
Port Benefits ............................................................................... 329Ports and the File System........................................................... 330
Ports Table ................................................................................. 330
Quick Reference ............................................................................. 333Remote System Operations............................................................ 334
Remote Systems Table .............................................................. 334Key Generation .................................................................................. 335
Specifying Key Mapping for a Table ........................................... 336
Part 13: MDM UOM Manager................................................. 339
Introduction ..................................................................................... 341Getting Started ............................................................................... 342
Find Functionality ........................................................................... 344
Working with Dimensions ............................................................... 345Working with Units .......................................................................... 347
7/25/2019 Mdm Console 71
11/365
MDM Console Reference Guide xi
Part 14: CLIX Command Line Interface ............................... 351
Command Line Interface to MDM .................................................. 352
CLIX Commands ............................................................................ 353Master Data Server Commands ................................................. 353
Repository Control Commands .................................................. 354
Instance Control Commands ...................................................... 359Repository Copying Commands ................................................ 359
DBMS Commands ..................................................................... 361Server Commands ..................................................................... 361CLIX Arguments ......................................................................... 363
CLIX ........................................................................................... 364Option Flags ............................................................................... 364
Sending CLIX Commands to an SSL-Enabled Server ............... 365
CLIX Errors ................................................................................ 366
7/25/2019 Mdm Console 71
12/365
7/25/2019 Mdm Console 71
13/365
13
PART 1: BASIC CONCEPTS
This part of the reference guide explains essential concepts that willenable you to make the best use of MDM Console. We recommend thatyou become familiar with this material before starting to work with MDMservers and repositories.
7/25/2019 Mdm Console 71
14/365
7/25/2019 Mdm Console 71
15/365
MDM Console Reference Guide 15
What is a Master Data Server?
A Master Data Server (MDS) is the central hub of an MDM system. Itmanages access to master data in one or more MDM repositories,which it serves up to various clients across a network.
The various components of an MDM software environment, and howthey interact with the Master Data Server; are described below andillustrated inFigure 1.
MDM Console. MDM Console allows system managers toadminister and monitor MDM servers, and to create, maintain thestructure of, and control access to the MDM repositories.
MDM Clients. MDM clients interact with a Master Data Server toimport, access, manage, syndicate, and publish master data. Clientsinclude MDM rich user interfaces such as MDM Data Manager, MDMImport Manager, and MDM Syndicator, as well as customizableinterfaces such as iViews and APIs.
DBMS engine. Master data is stored in a commercial SQL DBMS,access to which is controlled by the Master Data Server. MDMsupports Microsoft SQL Server, Oracle, IBM DB2, and SAP MaxDB.
Figure 1. MDM software environment
7/25/2019 Mdm Console 71
16/365
16 MDM Console Reference Guide
MDMAUXILIARY SERVERS
In addition to the Master Data Server, an MDM system can include the
following auxiliary servers: Master Data Import Server (MDIS). Automates import of data into
an MDM repository.
Master Data Syndication Server (MDSS). Automates syndication ofdata from an MDM repository.
Master Data Layout Server (MDLS). Processes publication ofmaster data from an MDM repository.
Each of these auxiliary servers interact independently with a MasterData Server and, like the Master Data Server, can be administered fromwithin MDM Console.
NOTE SeeThe Master Data Import Serveron page233 formore information about MDIS.
NOTE See The Master Data Syndication Serveron page261 formore information about MDSS.
7/25/2019 Mdm Console 71
17/365
MDM Console Reference Guide 17
What is an MDM Repository?
What is an MDM repository? The incorrect or at best incomplete answeris often that a master data repository is simply a database, and alsosince a SQL-based RDBMS is often used for managing master data.
An MDM repository certainly includes a database of informationconsisting of text, images, PDFs, and other data about each record, upto millions of records for some repositories. But a master data repositoryis much more than just a large database, and size by itself does notmake a database a master data repository. Rather, it is the richness andcomplexity of the underlying information itself and the ways it can besearched and published that uniquely characterize an MDM repository.
Moreover, when an MDM repository of product information is publishedas a catalog, the repository of master data is also a sales tool, whichlists the products offered for sale by a vendor and allows potentialcustomers to browse those products in a convenient way. Often, thepublished catalog is the only point of contact a customer will have with avendor, which makes the presentation of the product information theorganization and the design of the published catalog criticallyimportant to creating brand recognition and a distinct vendor identity. Soa published catalog is also about creating and reinforcing a corporate
image.Hundreds of details, large and small, must be addressed to turn adatabase into a meaningful master data repository, including:
Rich master data. Rich structured, master data is the essentiallifeblood of a usable MDM repository. For example, an MDMrepository of product information must contain much more than basictransactional data consisting of just a part number, a price, and aforty-character description for each product. Master data mustinclude not only fields of information common to all the products inthe repository, such as part number and price, but also detailedproduct specifications (attributes) that may apply to only a subset ofthe products. Master data should also include rich content such asimages, text blocks, and PDFs (for MSDS and other data sheets).
Classification. Rich master data is not enough. The records need tobe organized and classified into a taxonomy consisting of an arbitraryhierarchy of categories and subcategories, the hierarchy may containany number of levels, and multiple simultaneous taxonomies maycoexist in the same MDM repository. And a single category must be
able to appear in multiple places within the hierarchy. For example,in an MDM repository of product information, a printer accessoriescategory might be placed under both a printers category and anaccessories category.
7/25/2019 Mdm Console 71
18/365
18 MDM Console Reference Guide
Product families. A printed catalog of product information providesan excellent model for how information on groups of records withinan MDM repository of product information should be organized intoproduct families (also called units, presentations, or modules), whichfurther partition the products in each category into smaller groups ofproducts based upon the values of other fields and/or attributes. Inaddition to the individual products that comprise the family, a productfamily includes the family data (such as an image, a descriptiveparagraph, and feature bullets) as well as detailed specifications oneach of the products arranged into a well-structured tabular layout.
Product relationships. As a sales tool, a published catalog ofproduct information requires the wide variety of product relationships
that are essential for effective selling. Relationships include structuralrelationships, such as assemblies (a SKU of SKUs), kits (a SKU ofnon-SKUs), bundles (a non-SKU of SKUs), and matching sets(e.g. nuts and screws), as well as merchandising relationships, suchas cross-sells, up-sells, accessories, and consumables. An MDMrepository of product information must be able to capture andrepresent all of these product relationships.
MDMREPOSITORY STRUCTURE
A thorough understanding of the table and data types at your disposal isessential for properly creating and maintaining MDM repositories. Thissection provides an introduction to these concepts, which will beaddressed again later in this guide.
An MDM repository consists of the following tables:
Main tables. Every MDM repository has one or moremain tables. Amain table contains primary information about a business object suchas a product or supplier. For example, a repository might containseparate main tables for products and business partners. Theproducts main table would include an individual record for eachproduct and individual fields that apply to all products, such as SKU,product name, product description, manufacturer, price, andbusiness partner. The business partner main table would theninclude an individual record for each partner and individual fields foreach piece of information that describes the partner. Most of the timeyou will be looking at information in a main table.
NOTE When you first create a new MDM repository, MDMautomatically creates a main table named Products.
7/25/2019 Mdm Console 71
19/365
MDM Console Reference Guide 19
Subtables . An MDM repository can have any number of subtables.A subtable is usually used as a lookup table to define the set of legalvalues to which a corresponding lookup field in the main table can beassigned; these tables hold the lookup information. For example, amain table of an MDM repository of product information may includea field called Manufacturer; the actual list of allowed manufacturernames would be contained in a subtable. Only values that exist inrecords of the subtable can be assigned to the value of thecorresponding lookup field in the main table.
DATA INTEGRITY Lookup subtables are just one of the powerfulways that MDM enforces data integrity in an MDM repository. The setof legal values associated with lookup fields also makes the MDM
repository much more searchable, since a consistent set of values isused across the entire repository.
Object tables. Object tables, including the Images, Sounds, Videos,Binary Objects, Text Blocks, Copy Blocks, Text HTMLs, and PDFstables, are a special type of lookup subtable, where each object tableis used to store a single type of object. You cannot store an objectdirectly in a main or subtable field in an MDM repository. Instead,each object is defined or imported into the repository once and thenlinked to a main or subtable field as a lookup into the object table of
that type.DATA INTEGRITY Object tables eliminate redundant information,since each object appears only once in the MDM repository even if it islinked to multiple records.
NOTE When you first create a new MDM repository, MDMautomatically creates the single instance of each object table.
NOTE You can also store text blocks directly in a large text field inmain and subtable records rather than as a lookup into a text blocksubtable if you do not intend to reuse the blocks of text.
Special tables. Special tables include the Image Variants, Masks,Families, Relationships, Workflows, Named Searches, Tuples, DataGroups, and Validation Groups tables.
NOTE When you first create a new MDM repository, MDMautomatically creates the single instance of each special table.
NOTE The Data Groupsand Validation Groups tables do notappear anywhere in MDM Console.
7/25/2019 Mdm Console 71
20/365
20 MDM Console Reference Guide
System tables. System tables appear under the Admin node in theConsole Hierarchy and include Roles, Users, Connections, ChangeTracking, Remote Systems, Ports, Links, XML Schemas, andReports, and Logs.
NOTE When you first create a new MDM repository, MDMautomatically creates the single instance of each system table.
NOTE The Logs table is MDM server-specific rather than MDMrepository-specific, and appears in the Console Hierarchy under anMDM Server node after all of the MDM repository nodes.
TAXONOMIES
A taxonomy is a general term for classification scheme. The purpose ofa taxonomy is to group like things together into categories, usuallybased on a set of common, category-specific characteristics, orattributes.
In the context of master data management, a taxonomy is what makes itpossible to quickly locate a few specific records or categories in adatabase of thousands, tens of thousands, or even millions of records.
A taxonomy is usually hierarchical, meaning that some categories aresubcategories of other categories. (In the MDM system, taxonomytables are always hierarchical.) Most people are familiar, for example,with at least part of the hierarchical taxonomy used to classify animals,such as vertebrates mammals primates chimpanzees, and soon. Another example that you might experience in your daily life isgroceries beverages carbonated decaffeinated. Each level ofthe hierarchy gets narrower in terms of what it includes.
MDM uses a hierarchical taxonomy of categories to structure master
data in an MDM repository. A hierarchical taxonomy is typicallyrepresented as a tree, as shown inFigure 2.
7/25/2019 Mdm Console 71
21/365
MDM Console Reference Guide 21
Figure 2. Hierarchical taxonomy tree
ATTRIBUTES
In a taxonomy, every category has its own defining characteristics (inaddition to those of every category above it in the hierarchy). Forexample, in the taxonomy of animals, primates have specificcharacteristics as well as those of mammals and vertebrates.
In an MDM repository, these characteristics are called attributes, andcorrespond to fields of information that apply only to some rather thanall of the main table records in the MDM repository. For example,
voltage might be an attribute that applies to motors but not to gears.
Every taxonomy table has a pool of attributes associated with it. Fromthis pool you can link attributes to one or more individual categories ona category-by-category basis. MDM allows you to manage the pool ofattributes associated with a taxonomy table in Taxonomy mode.
In MDM, attributes are associated with linked to categories.Attributes then become associated with main table records by assigningrecords to categories. When you assign a record to a category, itacquires the attributes linked to that category as well as the attributeslinked to the parent category and all of the other ancestors of thatcategory through inheritance. Thus a main table record consists ofcommon fields, inherited attributes, and category-specific attributes. Youcan modify the attributes themselves as well as the set of attributeslinked to any specific category in MDM using Taxonomy mode.
Cate or
Subcategories
7/25/2019 Mdm Console 71
22/365
22 MDM Console Reference Guide
NOTE In MDM, an attribute is like a field, but one that applies onlyto a subset of the records in the main table. By contrast, a field is partof every record in the main table. If a particular attribute can be applied
to every main table record, then it should be set up as a field in themain table. For example, every record in an MDM repository ofproducts probably has an item number; therefore Item Numbershould be defined in the database as a field, and not as an attribute.
QUALIFIED TABLES AND QUALIFIERS
A qualified table is a special kind of lookup table that is extremelyversatile. It can be used to efficiently store complex relationships
between a main table record and one or more lookup table records thatcontain various types of additional information.
A qualified table stores a set of lookup records, and also supportsqualifiers, database subfields that apply not to the qualified tablerecord by itself, but rather to each association of a qualified table recordwith a main table record. Qualified tables offer self-configuring, out-of-the-box support for multiple prices (including quantity price breaks),cross-reference part numbers, other distributor/supplier/customer-specific information; and product applications.
PRODUCTAPPLICATIONS ANDAPPLICATION-BASED SEARCH
A product application is a particular use of a product. Applications areespecially important in certain industries where application-drivenproduct selection is the traditional way to locate products within a largeMDM repository of complex product information.
For example, in the automotive parts business, customers typicallyselect parts based not on the category or manufacturer but rather on theparticular year, make, model and engine type of the vehicle. There are
millions of parts, tens of thousands of different vehicles, and since eachpart can be used in more than one vehicle, tens of millions ofapplications. Finally, the use of the part is often further qualified byspecific characteristics of the vehicle, such as whether or not it has airconditioning or is California-equipped.
In an MDM repository, product applications stored in qualified tables candramatically reduce the duplication of data that has historically plaguedmost application-based systems. In the automotive example, parts arestored in the main table, the valid table of vehicle specifications are
stored in the qualified table, and each application of a part to a vehicle isrepresented by assigning the vehicle specification to the part.
Note that each lookup record in a qualified table is generic, in that itdoes not include the various conditions that might further qualify the useof the product in that application, even though the particular applicationmay require additional conditions to properly define it.
7/25/2019 Mdm Console 71
23/365
MDM Console Reference Guide 23
In MDM, these additional conditions are called qualifiers. Qualifiersallow a single lookup record to be used for multiple applications that arebasically the same except for the additional conditions, dramatically
reducing the number of distinct applications in the qualified table andavoiding a tremendous amount of data duplication.
In the automotive example, qualifiers allow a single vehicle specificationrecord to be used for vehicles that are equipped differently. Thiseliminates the explosion of vehicle specifications that normally occurswhen the additional conditions for each application result in additional but almost identical vehicle specification records, as in most existingapplication-based systems.
TIPWith or without product applications per se (or the need forapplication-based search), a qualified table can also be used to storeany large set of subtable records that contain fields whose values aredifferent for each main table record, such as multiple prices fordifferent quantities, divisions, regions, or trading partners, cross-reference part numbers, and additional distributor/supplier/customer-specific information for different distributors, suppliers, or customers.
PRODUCT FAMILIES
When you publish the contents of an MDM repository of productinformation, records often need to be organized into a more granularstructure than that provided by the categories of the taxonomy. Thisincreased granularity often involves grouping main table records basednot only on the category but also on other criteria (such as themanufacturer). Product families provide a way of organizing andidentifying these groupings.
A product family is a group of main table records that are related by oneor more common fields and/or attributes having the same value, and
that may also have additional fields of family data, such as an image, alogo, a paragraph of descriptive text, bullets of specifications, and so on.
Product families enable master data to be efficiently published not onlyto paper, but also to non-paper media such as the Web in a manner thatpreserves the presentation and organization seen in printed catalogs,with the added benefit of fast, efficient search.
Most master data management systems require that product families (ofwhich there may be thousands) be manually created. Further, theyrequire that main table records be manually added to the families, and
also that they be manually moved to a different family if changes in therecord result in its no longer belonging to its original family.
NOTE In other systems, a product family may be referred to as apresentation, a unit, or a module.
7/25/2019 Mdm Console 71
24/365
24 MDM Console Reference Guide
By contrast, the MDM system uses an innovative approach tostructuring, storing, and maintaining product family information thatovercomes the shortcomings of other master data management
systems. It embodies patent-pending technology that intelligentlyautomates the creation and management of product families, while atthe same time preserving family integrity across changes to the familystructure, changes to main table records (including adding and deletingrecords), and even changes to the taxonomy itself.
DATA INTEGRITY Layering the family hierarchy on top of thetaxonomy hierarchy leverages all of the planning and work that wentinto developing the taxonomy in the first place.
PRODUCT MASKS
Using MDM product masks, you can slice and dice a single masterMDM repository of product information into an effectively unlimitednumber of custom virtual repositories, dramatically simplifying themaintenance of a single repository targeted at multiple audiences. Eachvirtual repository can contain a different subset of products from themaster, and appears to the user as a completely private repository.
Product masks can be used to create virtual repositories for a variety of
purposes including custom subsets for contract customers andtargeted market segments all driven by a single MDM repository.
Unlike SQL views, product masks impose no performance penaltywhatsoever, and are defined at the individual product level rather thanthe query level. To the user of the MDM system, they appear as simplyanother dimension of the multidimensional search; on the Web, a maskcan be automatically applied to the published electronic catalog uponsite entry, so that each user sees only the slice of the MDM repositorythat you want them to see.
DATA INTEGRITYProduct masks allow you to create multiplecustom subset repositories from a single master MDM repositorywithout duplicating the underlying main table records. This guaranteesconsistency and synchronization of the data across updates, sincethere is never more than one copy of each main table record.
DATA INTEGRITYFor proper organization of the records withinan MDM repository, a hierarchy lookup field can normally be assignedonly to the value of a leaf node in the hierarchy, and similarly, recordscan be assigned only to a leaf node of the Masks hierarchy.
7/25/2019 Mdm Console 71
25/365
MDM Console Reference Guide 25
DATA GROUPS
As described under Taxonomiesabove, a large MDM repository may
contain hundreds of thousands and even millions of main table records,and these records can be organized within MDM into a hierarchicaltaxonomy of categories and subcategories.
Just as significantly, the same repository may contain tens or hundredsof thousands of images, text blocks, and PDF files. These objects alsoneed to be organized so that it is possible to locate an object or group ofobjects for linking to a particular record.
In MDM, each object is assigned to a data group when it is first createdor imported into the system. A data group is simply a group of objects,
and the set of data groups is organized into a hierarchy similar to thetaxonomy hierarchy.
Just as the taxonomy hierarchy is used to organize and break the entirecollection of main table records into manageable subgroups calledcategories, the data groups hierarchy is a parallel classification schemeused to organize objects into subgroups called data groups. Forexample, you might have separate data groups for Product Images,Category Icons, and Manufacturer Logos.
VALIDATIONS AND VALIDATION GROUPSMDM validations are Excel-like formulas that return a Boolean successor failure result. Validations can reference fields and attributes, performarithmetic, string, and logical operations, call built-in functions, and evenreference other previously defined validations.
Validations are defined and executed within MDM Data Manager. UsingMDM validations, you can define complex tests for all types ofconditions, and then run those tests against a group of one or morerecords, all without using a query language.
You can also define category-specific validations as branches of asingle validation, and MDM automatically executes the applicablevalidation based on the value of the category for each record.
Finally, you can assign each validation to one or more validation groups.Each validation group is a set of validations that can be convenientlyexecuted as a group with a single selection rather than forcing you torun each individual validation separately.
DATA INTEGRITY Unlike an Excel formula, a validation
expression is token-based, so that you do not have to type field,attribute, operator, or function names, and can instead select themfrom drop-down lists, reducing the potential for typing error.
7/25/2019 Mdm Console 71
26/365
26 MDM Console Reference Guide
DATA INTEGRITY Validation groups allow you to organize largesets of related validations, eliminating the likelihood of forgetting to runany of the individual validations in the group.
DATA QUALITY AND MDM
Despite lacking explicit semantic data quality capabilities, MDM is notonly a platform for master data management, but also a platform fordata quality. For example, MDM does not have an explicit capability tostandardize part numbers and yet it has functions that allow you tosearch in strings, to replace in strings, and so on. From these basicfunctions, you can build various and powerful standardize part numbercapabilities.
7/25/2019 Mdm Console 71
27/365
27
PART 2: STARTING MDM CONSOLE
This part of the reference guide explains how to start and stop MDMConsole and describes the various panes and tabs of its main window.It also includes a summary of options for configuring MDM Console,MDM server, MDM repository, and DBMS settings.
7/25/2019 Mdm Console 71
28/365
7/25/2019 Mdm Console 71
29/365
MDM Console Reference Guide 29
Starting and Exiting MDM Console
This section gets you up and running as quickly as possible in MDMConsole. Before you begin, you need to be sure that the SQL DBMS(SQL Server, Oracle, DB2, or MaxDB) is up and running and that theMDM software is already installed on your system.
NOTE You can run multiple MDM Console sessions on the samecomputer.
To start MDM Console from either the Desktop or the Start menu:
From the Desktop, double-click the MDM Console icon (shown at left),
or from the Startmenu, choose Programs > SAP MDM > MDM Console.After a few seconds, the MDM Console main window comes up.
NOTE Once MDM Console has been started, you may still needto perform some or all of the following additional steps before an MDMrepository can be accessed by an MDM client or other clients on thenetwork:
(1) Mount a Master Data Server (see Mounting and Unmounting theMaster Data Serveron page192);
(2) Start the Master Data Server (see Starting and Stopping onpage193);
(3) Create a new MDM Repository (see Creating an MDMRepositoryon page105)or mount an existing one (seeMounting and Unmounting the Master Data Serveron page44;and/or
(4) Load the MDM repository (see Loading and Unloading an MDMRepositoryon page47).
To exit MDM Console:
1. Click the close button in the upper right corner of the window, orchoose File > Exitfrom the main menu.
NOTE If you exit MDM Console without stopping a running MDMserver, the server remains running without the connection to your MDMConsole session.
2. MDM prompts you to ask if you would like to save the list of mountedservers to an MDM Console Settings file (described in the followingsection). Click:
Yes save the settings and exit No exit without saving Cancel return to the MDM Console session
7/25/2019 Mdm Console 71
30/365
30 MDM Console Reference Guide
MDMCONSOLE SETTINGS FILE
Normally, each time you launch MDM Console, you must manually
mount one or more MDM servers one at a time (even if you left themmounted when you exited the previous MDM Console session).
However, when you exit MDM Console, MDM allows you to save the listof currently mounted MDM servers to an MDM Console settings file,which then can be used to remount the servers as a group during asubsequent MDM Console session.
NOTE Just as the MDM Console settings file maintains a list ofcurrently mounted MDM servers that you can use to remount them asa group during subsequent MDM Console sessions, each Master Data
Server maintains a list of currently mounted MDM repositories thatpersists even after the Master Data Server is stopped that it uses toautomatically remount them as a group each time the Master DataServer is restarted.
During a subsequent MDM Console session, you can either load the listfrom the file using the File > Opencommand from the main menu, oryou can load the list automatically by appending the full pathname of aspecific .mcsfile to the command line that launches MDM Console.
NOTE You can save different sets of mounted MDM servers indifferent .mcsfiles, which allows you to define and choose the specificsets of MDM servers that you want to mount as a group.
To load a specific MDM Console Settings file from within MDMConsole:
1. Choose File > Openfrom the main menu
2. MDM prompts you to save the current mounted settings. Click:
Yes save the settings and exit No exit without saving Cancel return to the MDM Console session
3. MDM opens the Windows file Open dialog. Navigate to the desiredfolder, select the .mcssettings file you want to load, and click Open.
4. MDM replaces the set of mounted MDM servers with the group ofservers listed in the file.
7/25/2019 Mdm Console 71
31/365
MDM Console Reference Guide 31
To automatically load an MDM Console Settings file at MDM Consolestartup:
1. If a Desktop shortcut to MDM Console does not already exist, createone.
2. In the Shortcut properties of MDM Console Desktop shortcut, add thefollowing text to the Target field:
- f "full-pathname-of-settings-file. mcs"
3. where full-pathname-of-settings-fileis the full pathname of the .mcsfileyou want to use when launching MDM Console.
4. When you start MDM Console from the Desktop shortcut, MDMautomatically mounts the MDM server(s) that were saved in the
specified .mcsfile.
To automatically save an MDM Console Settings file when exitingMDM Console:
1. If a Desktop shortcut to MDM Console does not already exist, createone.
2. In the Shortcut properties of MDM Console Desktop shortcut, add thefollowing text to the Target field:
- q3. When you exit MDM Console, MDM automatically saves the list of
currently mounted MDM servers to the .mcsfile.
TIPYou can save the list of currently mounted MDM servers tothe current .mcsfile at any time by choosing File > Savefrom the mainmenu. You can also use the File > Save Ascommand to save the list toan .mcsfile that you name yourself.
NOTEIf you unmount all MDM servers from MDM Console, youwill not be prompted to save changes when exiting MDM Console norwill the .mcsfile be saved automatically.
7/25/2019 Mdm Console 71
32/365
32 MDM Console Reference Guide
COMMAND LINEARGUMENTS
For convenience, several command line arguments can be used when
starting MDM Console from the command line or a Windows shortcut.The arguments are either - switches or arguments to a particularswitch, as described inTable 1.
Table 1. MDM Console Command Line Arguments
Argument Descript ion
- f "f i l epath"
Starts MDM Console and mounts the MDM servers specified in apreviously saved MDM Console Settings (.mcs) file.
Consol e f "C: \ Deskt op\ SAP MDM Ser ver s. mcs"
Can be used with either - xor q.
- m
Mounts (and starts, if needed) the specified Master Data Server.
Consol e m MyMDM
By also setting Aut ostart =Truein the mds.inifile, you can notonly start the specified Master Data Server, but cause it toautomatically load the repositories it has mounted.
- q
Saves the MDM Console Settings (.mcs) file without promptingwhen you exit MDM Console.
Consol e f "C: \ Deskt op\ SAP MDM Server s. mcs" - q
Works only with - fbut is superceded by -x.
- x
Does not save or prompt you to save the MDM Console Settings(.mcs) file when you exit MDM Console.
Consol e f "C: \ Deskt op\ SAP MDM Ser ver s. mcs" - x
Works only with - fand supersedes -q.
- h Displays and describes these command line arguments.
NOTE Use CLIX to perform Console operations from thecommand line (see Command Line Interface to MDMon page352 formore information).
7/25/2019 Mdm Console 71
33/365
MDM Console Reference Guide 33
MDM Console Main Window
The main window of MDM Console consists of the panes and tabsshown in the numbered callouts ofFigure 3.
Figure 3. MDM Console main window
These panes and tabs, listed below, are described in further detail in thefollowing sections and throughout this reference guide:
1. Console Hierarchy pane
2. Objects pane
3. Object Detail pane
4. Functions tab5. Tables and Fields tab
6. Status bar
CONSOLE HIERARCHY PANE
The Console Hierarchy pane (left pane) contains a tree representing thehierarchy of MDM servers, MDM repositories, and tables. When fullyexpanded, the tree shows the mounted MDM servers, the mounted
repositories on each Master Data server, and the tables within eachrepository.
NOTEIn most cases, you will have only one Master Data Serverand one MDM repository. However, you can simultaneously mountmultiple MDM Servers and each Master Data Server cansimultaneously mount and access multiple MDM repositories.
1 2
3
6
4 5
7/25/2019 Mdm Console 71
34/365
34 MDM Console Reference Guide
OBJECTS PANE
The Objects pane (top-right pane) lists the MDM objects that
correspond to the selected node in the tree (i.e. root, Master DataServer, MDM repository, table), with a row for each object and a columnfor each object property. Use the Objects pane to browse, sort, andselect objects for editing or deletion.
Table 2. Nodes in the Console Hierarchy Tree
Selected Node Objects Pane Object Detail Pane
Root MDM Servers Server Detail
Any Master Data Server Repositories Repository Detail
Any MDM repository Tables Table DetailAny main table Fields Field Detail
Any subtable Fields Field Detail
Image Variants table Variants Variant Detail
Masks table Fields Field Detail
Families table Fields Field Detail
Relationships table Relationships Relationship Detail
Workflows table Fields Field Detail
Named Searches table Fields Field Detail
Tuples table Tuples Tuple Detail
Tuple Member Fields Member Field Detail
Admin Empty Empty
Roles table Roles Role Detail
Users table Users User Detail
Connections table Connections Connection Detail
Change Tracking Empty Change Tracking Detail
Remote Systems table Remote Systems Remote System Detail
Ports table Ports Port Detail
Links table Links Link Detail
XML Schemas table XML Schemas XML Schema Detail
Reports table Reports Report Detail
Logs table Logs Log Detail
Activities table Activities Activity Detail
Auxiliary Servers MDM Auxiliary Servers MDM Auxiliary Server Detail
Any Auxiliary Server Repositories Repository Detail
NOTE Boththe type of object displayed in the pane and the nameof the Objects pane itself changes as you select each type of node inthe tree, as summarized inTable 2.
7/25/2019 Mdm Console 71
35/365
MDM Console Reference Guide 35
OBJECT DETAIL PANE
The Object Detail pane (bottom-right pane, or tab in bottom-right pane
for Roles table) contains a two-column grid. The first column is the rowheader and lists the properties for each object; the second column liststhe corresponding values. Use the Object Detail pane to view and editthe properties of the object selected in the Objects pane.
NOTE As you select each type of node in the tree, the name ofthe Object Detail pane changes to correspond to the type of objectcontained in the Objects pane, as summarized inTable 2 above.
FUNCTIONS TABThe Functions tab (tab in bottom-right pane; Roles table only) containsa grid (Figure 4)with a hierarchy of functions (e.g. Add Records, ModifyRecords, and so on), and for each function, whether or not the functioncan be executed.
Figure 4. Functions tab for the Roles table
7/25/2019 Mdm Console 71
36/365
36 MDM Console Reference Guide
TABLES AND FIELDS TAB
The Tables and Fields tab (tab in bottom-right pane; Roles table only)
contains a grid (Figure 5)with a hierarchy of tables and fields, and foreach one, the type of read-write access granted, and any additionalconstraints.
Figure 5. Tables and Fields tab for the Roles table
STATUS BAR
The status bar displays the number of objects displayed in the Objectspane.
7/25/2019 Mdm Console 71
37/365
MDM Console Reference Guide 37
Configuration Parameters
You can configure settings for MDM Console, MDM servers, MDMrepositories, and the underlying DBMS server.
CONSOLE SETTINGS
These settings include those that define the graphic layout of your MDMConsole main window, which are stored in the Windows registry, andthe list of mounted MDM Servers, which are saved in an MDM ConsoleSettings (.mcs) file and can be loaded from the File menu or on startup(see MDM Console Settings Fileon page30).
MASTER DATA SERVER SETTINGS
These settings determine how the MDM Server behaves on themachine on which it is installed, independent of the MDM Console onwhich it is mounted and any DBMS Servers that hold the MDMrepository information. They will be the same for this MDM Serverregardless of which machine is running MDM Console and whichrepository is mounted or loaded. The settings are stored in an operatingsystem independent file (rather than the Windows registry) namedmds.ini.Following installation, and on an occasional basis, you mayneed to edit this file (see MDS Configurationon page212).
MDMAUXILIARY SERVER SETTINGS
Each auxiliary server (MDIS, MDSS, and MDLS) has its ownconfiguration file which governs its behavior. See MDIS Configurationon page248 for more information about the MDIS configuration file andMDSS Configurationon page267 for more information about theMDSS configuration file.
REPOSITORY PROPERTIES
These properties are specific to each MDM repository and will be thesame regardless of which Master Data Server mounts and loads it andwhich client accesses it (see Modifying Repository Propertieson page112).
DBMSSETTINGS
Unlike the Repository Properties, which are specific to a particular MDM
repository, these settings are relevant to a particular DBMS Server, andare the same for any Master Data Server that accesses it and for allrepositories mounted on it. In general these settings allow you toconfigure parameters regarding the DBMS Servers use of the filesystem (see DBMS Settingson page224).
7/25/2019 Mdm Console 71
38/365
7/25/2019 Mdm Console 71
39/365
39
PART 3: MDM SYSTEM ACCESS
This part of the reference guide provides an overview of Master DataServers and repositories, and the operations for accessing andcontrolling them.
7/25/2019 Mdm Console 71
40/365
7/25/2019 Mdm Console 71
41/365
41
Accessing MDM Repositories
When the selected node in the Console Hierarchy tree is a Master DataServer, the Objects pane (top-right) is titled Repositories and the Object
detail pane (bottom-right) is titled Repository Detail.The Repositories pane contains a grid with a list of mounted MDMrepositories, where each repository in the list corresponds to a child ofthe selected Master Data Server node; to view a repositorys properties,select the repository from the Repositories pane.
The properties for each MDM repository are listed inTable 3.
Table 3. MDM Repository Properties
Property Description
Name The MDM repository name.
Description1 The MDM repository description.
DBMS Server The network ID of the DBMS server that is hosting the repository.
DBMS Type
The DBMS brand:
SQL Server Oracle DB2 MaxDB
Login The login name for the DBMS server.
Password2 The password for the DBMS server.
Port1 The TCP/IP port number on which to connect to the repository.
Type1
The MDM repository type:
Normal Master Slave Publication Slave
Languages The languages supported by the MDM repository.
Status3
The MDM repository status:
Disconnected Unloaded Loading Loaded Running Remotely Outdated Newer than MDM ServerArchiving Unarchiving Duplicating Invalid Busy
1Hidden by default in the Repositories pane; unhide to display.2Not visible in either the Repositories or Repository Detail panes.3Not visible in the Repository Detail pane.
7/25/2019 Mdm Console 71
42/365
42 MDM Console Reference Guide
DBMS Servers
The DBMS Server property defines the network identification string of
the DBMS instance / machine / server that is used by the DBMS-specific client on the Master Data Server machine to connect to theDBMS. The brand of DBMS on which the repository is running is shownin the DBMS Type property.
NOTE When you mount two MDM repositories with the samename (but located on different DBMS Servers) on the same MasterData Server, MDM distinguishes them in the Console Hierarchy paneby appending the name of the DBMS Server in angular brackets to therepository name (e.g. repository ).
Repository Port Numbers
The Port property defines the TCP/IP port number that MDM clientapplications use to connect to the repository. This port number isactually the first of three sequential port numbers used by MDM (e.g.when MDM Console shows port 2345, it will also be using 2346 and2347). You may change the base port number to any value between2000 and 9999 in accordance with your preferences or systemrequirements, so long as you keep in mind that three sequential ports
are actually used for each assigned port number. Also, because onlyone repository can be loaded on a port at a time, it is recommended toassign each repository its own unique port number.
MDM Console users can assign or edit TCP/IP port numbers from theRepositories pane and during Mount, Create, Duplicate, and Unarchiverepository operations.
CAUTIONMDM client applications remember the port they usedto first connect to a repository, and, when attempting to connect to thatrepository in the future, will load whatever repository is currently
running on that port, even if it is not the repository expected by theuser. To avoid confusion, assign each repository its own unique portnumber and notify client users whenever a repositorys port numberchanges.
7/25/2019 Mdm Console 71
43/365
MDM Console Reference Guide 43
ACCESSING AN MDMREPOSITORY
In order to make an existing MDM repository visible to your MDMConsole session, you must first mount it. Once mounted, you can seethe repositorys current type and state and perform a number ofadministrative functions on it.
The type and current state of mounted repositories are indicated in theRepositories pane and by the icon used to represent the repository inthe Console Hierarchy tree, as shown inTable 4 andTable 5.
Table 4. MDM Repository Types
Icon1 Type
Normal MDM repository.
Master MDM repository.
Slave MDM repository.
Publication slave MDM repository.
Broken master MDM repository.
Broken slave MDM repository.Broken publication slave MDM repository.
Undetermined MDM repository type.2
1Type of MDM repository indicated by color on top of cylinder.2Type cannot be determined if repository is busy, disconnected, outdated, or invalid.
Table 5. MDM Repository States
Icon1
State
MDM repository is not connected to MDM Console.
MDM repository is not loaded.
MDM repository is being loaded.
MDM repository is loaded.
MDM repository is loaded on another MDS (running remotely).
MDM repository is scheduled to unload.
MDM repository is unloaded and being duplicated.
MDM repository is unloaded and being archived.
7/25/2019 Mdm Console 71
44/365
44 MDM Console Reference Guide
Icon1 State
MDM repository is being unarchived.
MDM repository is outdated.
Repository version is newer than Master Data Server
MDM repository is invalid.
MDM repository is busy.
MDM repository must be restarted.
MDM repository has a corrupt schema.1State of repository indicated by symbol at the lower right of the cylinder.
If a repositorys type is undetermined, its state often indicates thereason why. Suggested solutions for resolving undetermined repositorytypes are listed inTable 6.
Table 6. Solutions for Resolving Undetermined Repository Types
Reposi tory State Suggested Solution
Busy Refresh MDM Console after the currently running activity finishes.
Disconnected Connect to the repository.
Invalid Unmount and re-mount the repository.
Outdated Update the repository
Running RemotelyUnload the repository on the remote Master Data Server orappropriate it.
CAUTIONAppropriating a remotely-running Master Data Server
is potentially dangerous (see Appropriating an MDM Repositoryonpage148 for more information.
Suggested solutions for resolving repository states Requires RestartandSchema Corruptare listed inTable 6.
Table 7. Solutions for Resolving Requires Restart and Schema Corrupt
Reposi tory State Suggested Solution
Requires Restart Unload the repository and load it again.
Schema Corrupt Delete the repository and restore (unarchive) its backup.
The MDM Console operations to mount an existing MDM repository,and the various administrative functions that you can perform on amounted repository, are described in the following sections.
7/25/2019 Mdm Console 71
45/365
MDM Console Reference Guide 45
Mounting and Unmounting an MDM Repository
Mount an existing MDM repository in order to access it from a Master
Data Server. If your organization has more than one MDM repository,you only need to mount those that are of interest to you.
NOTE An MDM repository can exist on any machine on thenetwork to which you have access to the underlying SQL Server,Oracle, DB2, or MaxDB DBMS, and any Master Data Server on thenetwork can access and control access to each MDM repository.
NOTE Each Master Data Server maintains a list of currentlymounted MDM repositories that persists even after the server isstopped and then restarted. When you mount and connect to a MasterData Server that is already running, you will automatically see fromyour MDM Console all of the MDM repositories that have already beenmounted on that Master Data Server by any other MDM Console(including your own MDM Console during a previous session).
NOTE Mounting an MDM repositoryis apassword-protectedoperation which requires you to enter the password for the MasterData Server, if you have not already done so during the current MDMsession (see Master Data Server Securityon page279).
To mount an existing MDM repository:1. In the Console Hierarchy tree, right-click on the Master Data Server
and choose Mount Repositoryfrom the context menu, or select the treenode and choose Repositories > Mountfrom the main menu.
2. MDM opens the Mount MDM Repository dialog shown inFigure 6 withthe DBMS Name, Login, and Password fields enabled.
Figure 6. Mount MDM Repository dialog (1 of 2)
3. Select the DBMS Server to which you want to connect from the drop-
down list.4. Enter the appropriate DBMS login (which must have system
administrator privileges) and password for the selected DBMS Serverand click Next.
5. MDM disables the DBMS Server, Login, and Password fields andenables the Repository Name and Port fields, as shown inFigure 7.
7/25/2019 Mdm Console 71
46/365
46 MDM Console Reference Guide
Figure 7. Mount MDM Repository dialog (2 of 2)
6. Select the MDM repository you want to mount from the drop-down list.
7. If necessary, edit the TCP/IP port number in the Port text box.NOTE See Repository Port Numberson page42 for moreinformation about port numbers.
8. Click Finishto mount the MDM repository.
9. MDM adds a node for the MDM repository to the Console Hierarchytree as a child of the Master Data Server. The repository status icon(shown at left) displays a gray lockto indicate that a connection torepository has not yet been established.
To unmount an MDM repository:
1. In the Console Hierarchy tree, right-click on the MDM repository youwant to unmount and choose Unmount Repositoryfrom the contextmenu, or select the tree node and choose Repositories > Unmountfrom the main menu.
TIPIf the top-right pane is currently displaying the list of MDMrepositories, you can also right-click on the repository in the grid andchoose Unmountfrom the context menu.
2. MDM removes the repository node from the Console Hierarchy tree.
Connecting to and Disconnecting from an MDM Repository
Once you have mounted an MDM repository, you must connect to itbefore any further repository operations can be performed.
To connect to a disconnected MDM Repository (gray lock):
1. In the Console Hierarchy tree, right-click on the MDM repository towhich you want to connect and choose Connect to Repositoryfrom the
context menu, or select the tree node and choose Repositories >Connect to Repositoryfrom the main menu.
2. MDM opens the Repository Login dialog shown inFigure 8.Enter yourMDM user name and password for the selected repository and clickOK.
7/25/2019 Mdm Console 71
47/365
MDM Console Reference Guide 47
Figure 8. Connect to Repository dialog
NOTE See Users Tableon page282 for more information aboutMDM user names and passwords.
3. Once you are connected to the repository, MDM changes therepositorys icon in the Console Hierarchy tree to reflect is current typeand state.
4. MDM also populates the Tables and Table Detail panes with tableinformation for the MDM repository.
To disconnect from an MDM Repository:
1. In the Console Hierarchy tree, right-click on the MDM repository fromwhich you want to disconnect and choose Disconnect from Repositoryfrom the context menu, or select the tree node and chooseRepositories > Disconnect from Repositoryfrom the main menu.
2. MDM changes the repository status icon to a gray lockto indicate thatthe repository is now disconnected from the Console.
Loading and Unloading an MDM Repository
Once you have mounted and connected to an MDM repository, it mustnext be loaded before it can be accessed by clients on the network.
NOTE An MDM repository can be simultaneously mounted bymultiple Master Data Servers. When you load the MDM repository on a
particular Master Data Server, it then becomes inaccessible to all otherMaster Data Servers that have it mounted.
NOTE You can only load one repository on a TCP/IP port at atime (see Repository Port Numberson page42 for more information).
NOTE Thestructure of an MDM repository cannot be modifiedthrough MDM Console while the repository is loaded.
TIPIf you want to modify the structure of an MDM repository whilepreserving access to the current version, you can duplicate therepository and give it a new name, or use the sa