Professional Documents
Culture Documents
Sap Master Data Management Guide PDF
Sap Master Data Management Guide PDF
Sap Master Data Management Guide PDF
Target Audience
‡Ù˜Š Technical Consultants
‡Ù˜Š System Administrators
PUBLIC
‡Ù˜ð3Xï“7¼l©K4Ø¥ˆTÍs[XeÃ\fØ÷sŒÜ¹ëíòö�°5.¡gfix)�“æW¯¯…ıßæÞt‹’´9z
Document History
CAUTION
Before you start the implementation, make sure you have the latest version of this document.
You can find the latest version at the following location: http://service.sap.com/
instguides.
The following table provides an overview of the most important document changes.
Version Date Description
1.0 2010-05-31 Initial version
1.1 2011-12-07 Support Package 2 version. Help Portal paths corrected. Other updates.
1.2 2012-06-30 Updates in chapter Editing in Application Properties.
Chapter 7 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Chapter A Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
A.1 The Main SAP Documentation Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
The GDS Console is a mandatory component of the SAP NetWeaver MDM GDS business scenario,
enabling users to:
ø£½o˛D Retrieve information from back end SAP ERP or MDM systems, for processing on the GDS Console
ø£½o˛D Create, enhance, maintain, and store specific data on the GDS Console
ø£½o˛D Register and publish data to the data pools and the Global Registry
ø£½o˛D Manage publication of item data between suppliers and their trade partners
This manual describes how to install the SAP NetWeaver MDM GDS Console.
Use
The GDS Console is a Java-based application running on the SAP NetWeaver Application Server (Web
AS) Java, which is the main interface of SAP NetWeaver MDM GDS. Connected to the back-end system
through SAP NetWeaver Process Integration (PI) connectors, the GDS Console imports item data for
enhancement and storage, registration with the data pools and Global Registry, and subsequent
publication to trade partners.
Components
The GDS Console operates with the following components to execute processes within the SAP
NetWeaver MDM GDS business scenario:
1æ¤fiN MDM Server and Database
The GDS Repository is stored on the MDM Server. It includes the functionality required for backup
and restoration, and metadata management.
1æ¤fiN MDM Console
An MDM application used to administer and monitor the MDM Server software, and for creating,
backing up, and restoring repositories on MDM.
1æ¤fiN SAP NetWeaver Process Integration (PI) non-central J2EE Adapter Engine and PI AS2 Adapter (by
Seeburger)
Responsible for the secure transfer and synchronization of messages between the GDS Console
and the data pools. SAP NetWeaver PI is also used to transfer data between the back-end system
and the GDS Console.
1æ¤fiN ERP Back End System
Creates the items and transfers the initial data and item status changes to the GDS Console through
a system of messages.
1æ¤fiN SAP EHP1 for SAP NetWeaver CE 7.1 Java Stack (with SAP NetWeaver Portal Core - optional)
The GDS application runs on the SAP NetWeaver Java stack as a Web Dynpro application. The GDS
portal content can be deployed to the server if you select the “Portal Core” option. GDS is made
available as a workset in SAP NetWeaver Portal Core, thereby utilizing the portal features of single
sign-on and role based access. This is optional. The GDS application can also run in standalone
mode without the SAP NetWeaver Portal Core.
The figure below illustrates a typical minimum SAP NetWeaver MDM GDS technical landscape:
mhD;?Luflšfiõžþ*–Op⁄“
Before installing the GDS Console, be sure that you have performed all prerequisite procedures outlined
in the master guide for SAP NetWeaver MDM GDS. For more information, see SAP Service Marketplace
at http://service.sap.com/instguides Industry Solutions Industry Solution Guides SAP for Consumer
Products SAP MDM GDS 2.1 .
NOTE
The versions of all MDM components must be compatible with the required version of the GDS
Console.
The minimal system requirements for the GDS Console are listed in the following table:
CPU Dual Xeon 2.0 GHz with 533 MHz + FSB
Memory 2 GB RAM
Storage 18 GB
Network topology TCP/IP-based network
Operating system All SAP EHP1 for SAP NetWeaver PI 7.1 released operating systems and databases
AS Java Installed as part of SAP NetWeaver PI Adapter Engine
Version must be at least SAP EHP1 for SAP NetWeaver PI 7.1 Adapter Engine
SP04 P1
J2EE Adapter Engine Installed as part of SAP NetWeaver PI Adapter Engine
(component of SAP NetWeaver Version must be at least SAP EHP1 for SAP NetWeaver PI 7.1 Adapter Engine
Process Integration) SP04 P1
CAUTION
The GDS Console must be installed on the same server.
EP Basis (Enterprise Portal Installed as part of SAP EHP1 for SAP NetWeaver CE 7.1 SP04 P1
Basis components - Optional –
only if the user uses the CAUTION
application in portal mode) The GDS Console must be installed on the same server.
Before you begin installing the GDS Console, perform these preparatory steps:
1. Check that all the files required for installing the GDS Console are available on your installation
media. For more information, see Deploying the GDS Console Application [page 14].
2. Ensure that the MDM Server is running.
3. Create an MDM repository on the MDM Server that will be used by the GDS Console to store trade
items and other application data, as follows:
1. Copy the repository archive file \\DATA_UNITS\MDM_CONTENT_GDS
\GDS_21_<datapool>_INITIAL_REPOSITORY.A2A from the installation media to the Archives
folder of your MDM Server. On a Windows platform, you can find this folder in the following
path:
\\<SAPGLOBALHOST>\sapmnt\<SAPSID>\MDS<No>\mdm\archive
NOTE
There are two repositories delivered as part of MDM content, one for 1Sync data pool
and other one for SA2 data pool. Choose the right repository based on which data pool
you want GDS to interact with.
2. Start the MDM Console, mount the MDM Server, and unarchive the repository archive.
3. Connect to the repository with the following credentials:
CÿÈô&E User name: Admin
CÿÈô&E Password: abc123
4. Load the repository with indexes.
NOTE
For more information, see the console reference guide on SAP Service Marketplace at http://
service.sap.com/installmdm SAP NetWeaver MDM 7.1 Reference Documentation MDM 7.1 -
Console Reference Guide .
You can install the GDS Console in standalone and Portal mode.
Procedure
I:t¥@cŽv�»z'¦ Õ²=ˇÓb
If you are using GDS in standalone mode, you must install the SAP NetWeaver J2EE Adapter Engine.
The non-central J2EE Adapter Engine is an SAP NetWeaver Process Integration component.
Additionally, the following prerequisites apply:
Xõ
ã>( SAP EHP1 for SAP NetWeaver PI 7.1 Adapter Engine stack are installed and configured according
to the installation guide provided for SAP NetWeaver PI Adapter Engine.
For more information, see http://service.sap.com/instguides SAP NetWeaver SAP
NetWeaver Process Integration 7.1 Installation Installation - Standalone Engines Adapter Engine (Java EE) on
<operating system> for SAP NetWeaver 7.11 .
Xõ
ã>( Once the J2EE adapter engine is installed, patch the system to SAP EHP1 for SAP NetWeaver PI 7.1
SP04 Patch 1 or higher according to the SAP NetWeaver patch guides.
For more information about patch guides, see http://service.sap.com/instguides SAP
NetWeaver SAP NetWeaver Process Integration 7.1 Maintenance .
Xõ ˙ás– C3|oflgÞ$ ÿ
In distributed Portal mode, the SAP NetWeaver Portal Core component and the GDS UI can be deployed
on one J2EE server (GDS Portal instance), and GDS core and other required components can be deployed
on another J2EE server (GDS standalone instance). GDS UI deployed on the Portal instance remotely
communicates with the GDS standalone instance.
NOTE
When you install SAP NetWeaver CE, the ’CompPlatform Standard System’ installation includes
the Enterprise Portal Basis (EP Basis) components, so no separate portal installation is required.
The EP Basis components are part of usage type 'Composition Platform'. For more information,
see SAP Note 1229080.
If you use GDS in distributed Portal mode, first install the GDS standalone instance as described in
Installing the GDS Console in Standalone Mode [page 11]. Then, make sure that the following prerequisites are
fulfilled for the GDS Portal instance:
NÞsXdü SAP EHP1 for SAP NetWeaver CE 7.1 is installed and configured as described in the installation
guide provided for SAP NetWeaver composition environment.
For more information, see http://service.sap.com/instguides SAP NetWeaver SAP
NetWeaver Composition Environment SAP EHP1 for SAP NetWeaver CE 7.1 Installation Installing the CE
Server (64-Bit) .
NÞsXdü Once SAP NetWeaver Composition Environment is installed, patch the system to SAP EHP1 for
SAP NetWeaver CE 7.1 SP04 Patch 1 or higher according to the SAP NetWeaver patch guides.
For more information about patch guides, see http://service.sap.com/instguides SAP
NetWeaver SAP NetWeaver Composition Environment SAP EHP1 for SAP NetWeaver CE 7.1
Maintenance .
NÞs¾A5 Š¨ÂzA«ŸÎ×)6q
In non-distributed Portal mode, SAP NetWeaver Portal Core component, GDS UI, GDS core, and other
required components are deployed on single J2EE server.
NOTE
When you install SAP NetWeaver CE, the ’CompPlatform Standard System’ installation includes
the Enterprise Portal Basis (EP Basis) components, so no separate portal installation is required.
The EP Basis components are part of usage type 'Composition Platform'. For more information,
see SAP Note 1229080.
If you use GDS in non-distributed Portal mode, the following prerequisites apply:
ã½ Â+¹ SAP EHP1 for SAP NetWeaver CE 7.1 is installed and configured as described in the installation
guide provided for SAP NetWeaver composition environment.
For more information, see http://service.sap.com/instguides SAP NetWeaver SAP
NetWeaver Composition Environment SAP EHP1 for SAP NetWeaver CE 7.1 Installation Installing the CE
Server (64-Bit) .
ã½ Â+¹ Once J2EE adapter engine is installed, patch the system to SAP EHP1 for SAP NetWeaver CE 7.1
SP04 Patch 1 or higher according to the SAP NetWeaver patch guides.
For more information about patch guides, see http://service.sap.com/instguides SAP
NetWeaver SAP NetWeaver Composition Environment SAP EHP1 for SAP NetWeaver CE 7.1
Maintenance .
ã½ Â+¹ Deploy XI Adapter Framework, XI Adapter Framework Component, and Messaging System Service
components located at http://service.sap.com/instguides Downloads SAP Support Package
Support Packages and Patches - Entry by Application Group SAP NetWeaver SAP NetWeaver SAP EHP1
for SAP NW PI 7.1 Entry by Component Adapter Engine (Java EE) .
NOTE
You must deploy the GDS Console application using the JSPM tool. Choose the option New Software
Component.
Procedure
Use the following files, in the following order, to deploy the GDS Console application to the GDS host:
1. GDSCORE00_0.sca
2. GDSUI00_0.sca
3. GDSTOOLS00_0.sca
4. GDSDDIC00_0.sca
CAUTION
If you have an existing GDS 1.0 or GDS 2.0 installation, do not deploy this SCA.
In the GDS standalone instance, deploy the files as described in Deploying the GDS Console in Standalone
Mode [page 14].
In the GDS Portal instance, deploy the following files:
GDSUI00_0.sca
GDSPORTAL00_0.sca
Deploy the files as described in Deploying the GDS Console in Standalone Mode [page 14], followed by the
following file:
GDSPORTAL00_0.sca
Procedure
1. Log on to SAP NetWeaver Administrator at http://<host>:<port>/nwa.
2. Choose Configuration Management Infrastructure Java System Properties .
3. Select the Applications tab in the Details section
4. Filter the table for is~gds~core~app.
5. Set the parameters for the application properties file according to the table below and edit data.
To ensure that changes take effect in the SAP NetWeaver Administrator, restart the J2EE engine.
NOTE
Application properties marked bold are mandatory to be set by the customer in order to get the
GDS Console up and running.
Application Properties
NOTE
If there is no need to start a workflow for a particular trigger, remove the workflow name value
for that trigger property.
Procedure
1. Create an allow.ip text file in the \usr\sap\MDM\MDS<Instance number>\exe folder.
2. Add the IP address of the server where GDSCORE is deployed in this file.
NOTE
If you use GDS in distributed portal mode, add the IP address of the GDS standalone instance.
3. Log in to the Portal with Portal Administrator and create your new GDS portal user.
4. Add the following GDS portal role to the new GDS portal user:
Name pcd:portal_content/com.sap.pct/specialist
/SAP_NetWeaver_MDM_GDS/Roles/SAP_MDM_GDS
Now you can access the SAP GDS workset with the new users.
If the GDS portal user with the pcd:portal_content/com.sap.pct/specialist/SAP_NetWeaver_MDM_GDS/Roles/
SAP_MDM_GDS role has been created, the new GDS portal user has to log in to GDS in the portal
mode and choose the SAP NetWeaver MDM global data synchronization option tab. At the same time, a new
user with the same name as the GDS portal user is created in the GDS Console with the Everyone role.
NOTE
The new GDS portal user has only the rights defined in the Everyone role. Administrator users can
assign additional roles to the new GDS user.
NOTE
If your GDS portal user name is 'GDSAdmin', 'Admin', or 'Administrator', the new user gets
'Admin' role in MDM. Otherwise, it gets only the 'Everyone' role and the administrator can extend
the access rights.
NOTE
If you use GDS in distributed Portal mode, set the appropriate values for the following application
properties in the GDS portal instance for application is~gds~ui~model:
Property Name Default Value Comments
GDSCORE.nwserverhostname 127.0.0.1 IP address for the GDS
standalone instance
GDSCORE.nwserverport 50304 P4 port for the GDS standalone
instance
GDSCORE.nwsystemuser Administrator J2EE 'Admin' user for the GDS
standalone instance
GDSCORE.nwsystemuserpassword abc123 Password of user specified in
GDSCORE.nwsystemuser
NOTE
Check that everything has been set as described in the Editing the Application Properties [page 15] section.
5 Configuring Languages
You can define the languages you want your item to be published in for a selected target market.
For more information about configuring languages, see SAP Library for GDS 2.1 Console on SAP Help
Portal at http://help.sap.com/mdm-gds SAP Library GDS Metadata Management Defining Languages
for Target Markets .
To ensure that the GDS Console has been successfully installed and configured, perform the following
installation test.
Procedure
1. Log on using one of the following URLs:
Standalone http://<host name>:<port>/GDS/Console
2. On the site logon screen, enter a valid user name and password, and choose the Log On pushbutton.
The initial logon name is Admin, and the password is abc123.
NOTE
If you change the password, you must change it in the application property as well and restart
the application and the MDM connector using the Visual Admin Deploy service.
3. After a successful logon, your browser displays the GDS Console dashboard.
7 Troubleshooting
Procedure
If your logon fails or if error messages are displayed in your browser, perform the following steps to
troubleshoot the installation:
1. If an error is displayed on the user interface, follow the specific instructions for troubleshooting.
2. Verify the application properties.
For more information, see Editing the Application Properties [page 15].
3. Open the Deploy service of the Web AS using the SAP NetWeaver Administrator and verify that the
sap.com/is~gds~core~app application is running (marked with blue).
For more information about navigating the Deploy service, see steps 1, 2, and 3 in Restarting the GDS
Console in the solution operations guide for GDS on SAP Service Marketplace at http://
service.sap.com/instguides Industry Solutions Industry Solution Guides SAP for Consumer Products
SAP MDM GDS 2.1 Application Operations Guide .
4. If the problem is not solved, restart the MDM connector and the GDS Console.
For more information about restarting the MDM connector and the GDS Console, see Restarting
the GDS Console in the solution operations guide for GDS on SAP Service Marketplace at http://
service.sap.com/instguides Industry Solutions Industry Solution Guides SAP for Consumer Products
SAP MDM GDS 2.1 Application Operations Guide .
5. Use the Log Viewer service of the Web AS SAP NetWeaver Administrator to search for general
errors.
For more information about using the Log Viewer service, see Viewing the GDS Console Log in the
solution operations guide for GDS on SAP Service Marketplace at http://service.sap.com/
instguides Industry Solutions Industry Solution Guides SAP for Consumer Products SAP MDM GDS 2.1
Application Operations Guide .
A Reference
Cross-Phase Documentation
Implementation
The master guide is the starting point for implementing an SAP solution. It lists the required installable
units for each business or IT scenario. It provides scenario-specific descriptions of preparation,
execution, and follow-up of an implementation. It also provides references to other documents, such
as installation guides, the technical infrastructure guide and SAP Notes.
D ÷Ѐ& Target group:
D ÷ЀI Technology consultants
D ÷ЀI Project teams for implementations
D ÷Ѐ& Current version:
D ÷ЀI On SAP Service Marketplace at http://service.sap.com/instguides
The installation guide describes the technical implementation of an installable unit, taking into
account the combinations of operating systems and databases. It does not describe any business-related
configuration.
D ÷Ѐ& Target group:
D ÷ЀI Technology consultants
D ÷ЀI Project teams for implementations
D ÷Ѐ& Current version:
D ÷ЀI On SAP Service Marketplace at http://service.sap.com/instguides
Configuration Documentation in SAP Solution Manager – SAP Solution Manager is a life-cycle
platform. One of its main functions is the configuration of business scenarios, business processes, and
implementable steps. It contains Customizing activities, transactions, and so on, as well as
documentation.
D ÷Ѐ& Target group:
D ÷ЀI Technology consultants
D ÷ЀI Solution consultants
D ÷ЀI Project teams for implementations
D ÷Ѐ& Current version:
D ÷ЀI In SAP Solution Manager
The Implementation Guide (IMG) is a tool for configuring (Customizing) a single SAP system. The
Customizing activities and their documentation are structured from a functional perspective. (In order
to configure a whole system landscape from a process-oriented perspective, SAP Solution Manager,
which refers to the relevant Customizing activities in the individual SAP systems, is used.)
D ÷Ѐ& Target group:
D ÷ЀI Solution consultants
D ÷ЀI Project teams for implementations or upgrades
D ÷Ѐ& Current version:
D ÷ЀI In the SAP menu of the SAP system under Tools Customizing IMG
Production Operation
The technical operations manual is the starting point for operating a system that runs on SAP
NetWeaver, and precedes the application operations guides of SAP Business Suite. The manual refers
users to the tools and documentation that are needed to carry out various tasks, such as monitoring,
backup/restore, master data maintenance, transports, and tests.
=3žÿ¦ Target group:
=3žÿÉ System administrators
=3žÿ¦ Current version:
=3žÿÉ On SAP Service Marketplace at http://service.sap.com/instguides
The application operations guide is used for operating an SAP application once all tasks in the
technical operations manual have been completed. It refers users to the tools and documentation that
are needed to carry out the various operations-related tasks.
=3žÿ¦ Target group:
=3žÿÉ System administrators
=3žÿÉ Technology consultants
=3žÿÉ Solution consultants
=3žÿ¦ Current version:
=3žÿÉ On SAP Service Marketplace at http://service.sap.com/instguides
Upgrade
The upgrade master guide is the starting point for upgrading the business scenarios and processes of
an SAP solution. It provides scenario-specific descriptions of preparation, execution, and follow-up of
an upgrade. It also refers to other documents, such as upgrade guides and SAP Notes.
=3žÿ¦ Target group:
=3žÿÉ Technology consultants
=3žÿÉ Project teams for upgrades
=3žÿ¦ Current version:
=3žÿÉ On SAP Service Marketplace at http://service.sap.com/instguides
The upgrade guide describes the technical upgrade of an installable unit, taking into account the
combinations of operating systems and databases. It does not describe any business-related
configuration.
=3žÿ¦ Target group:
=3žÿÉ Technology consultants
=3žÿÉ Project teams for upgrades
=3žÿ¦ Current version:
=3žÿÉ On SAP Service Marketplace at http://service.sap.com/instguides
Release notes are documents that contain short descriptions of new features in a particular release or
changes to existing features since the previous release. Release notes about ABAP developments are the
technical prerequisite for generating delta and upgrade Customizing in the Implementation Guide
(IMG).
=3žÿ¦ Target group:
qs>g# Consultants
qs>g# Project teams for upgrades
qs>gL Current version:
qs>g# On SAP Service Marketplace at http://service.sap.com/releasenotes
qs>g# In the SAP menu of the SAP system under Help Release Notes (only ABAP developments)
Example Description
<Example> Angle brackets indicate that you replace these words or characters with appropriate
entries to make entries in the system, for example, “Enter your <User Name>”.
Example Arrows separating the parts of a navigation path, for example, menu options
Example
Example Emphasized words or expressions
Example Words or characters that you enter in the system exactly as they appear in the
documentation
http://www.sap.com Textual cross-references to an internet address
/example Quicklinks added to the internet address of a homepage to enable quick access to specific
content on the Web
123456 Hyperlink to an SAP Note, for example, SAP Note 123456
Example €lÈ⁄ˆ˘ Words or characters quoted from the screen. These include field labels, screen titles,
pushbutton labels, menu names, and menu options.
€lÈ⁄ˆ˘ Cross-references to other documentation or published works
Example €lÈ⁄ˆ˘ Output on the screen following a user action, for example, messages
€lÈ⁄ˆ˘ Source code or syntax quoted directly from a program
€lÈ⁄ˆ˘ File and directory names and their paths, names of variables and parameters, and
names of installation, upgrade, and database tools
EXAMPLE Technical names of system objects. These include report names, program names,
transaction codes, database table names, and key concepts of a programming language
when they are surrounded by body text, for example, SELECT and INCLUDE
EXAMPLE Keys on the keyboard
Disclaimer
Some components of this product are based on Java™. Any code change in these components may cause unpredictable and
severe malfunctions and is therefore expressly prohibited, as is any decompilation of these components.
Any Java™ Source Code delivered with this product is only to be used by SAP’s Support Services and may not be modified or
altered in any way.