DDR – Client Build Application – Local Client Copy

This guide explains how to perform a Local Client Copy using the Client Build functionality within the Dynamic Data Replicator (DDR) Shell Build application. It outlines the steps required to copy data from one client to another within the same SAP system, including configuration of source and target clients, parallel processing, system profiles, and performance-related options. The guide also provides an overview of SAP client copy profiles and how they influence the scope of data copied..

DDR Shell Build Guide

Client Build Application – Local Client Copy

The Dynamic Data Replicator (DDR) Client Build application assists SAP customers in creating new clients within test or lower environments. The application supports different client build options, including Client Export, Local Client Copy, and Remote Client Copy.

This guide focuses on Local Client Copy, which is used when a client needs to be copied from one client to another within the same SAP system. This option is useful when the source and target clients are hosted on the same server and the user wants to build a production-like lower environment using a selected SAP client copy profile.

Step 1: Access the Shell Build Application

DDR Shell Build screen with New button highlighted

Navigate to the Central Admin Console, select Shell, and click New.

Step 2: Select Client Build

DDR Shell Build popup showing Client Build option

In the Shell Build popup, select Client Build and click Create.

Client Build Options in DDR

DDR Shell Build provides three client build options:

Client Export

Creates a transport-based export from the source client, which can then be imported into the target client.

Local Client Copy

Performs a client copy from one client to another within the same SAP system.

Remote Client Copy

Performs a client copy from a different SAP system using RFC communication.

Step 3: Select Local Client Copy

DDR Client Build Type dropdown showing Local Client Copy

Select Client Local Copy when the source and target clients are in the same SAP system.

Step 4: Maintain Local Client Copy Details

DDR Local Client Copy configuration screen

Enter the source client, target client, number of parallel processes, lock option, split large table option, and system profile.

Step 5: Select the System Profile

Select the required SAP profile based on the type of data that needs to be copied.

Local Client Copy Configuration Fields

Connection

Select the connection between the DDR Central Console and the SAP system where the local client copy will be performed.

Client Build Type

Select Client Local Copy to copy from one client to another within the same SAP system.

Source Client

Enter the source client number from which the data will be copied.

Target Client

Enter the target client number where the copied data will be created or refreshed.

Number of Parallel Processes

Define the number of parallel work processes to be used. This helps improve throughput, but the value should be aligned with system capacity.

Lock Source Client

Allows DDR to lock the source client during the copy process if required. This helps protect consistency when changes should be prevented during execution.

Split Large Tables

Enables DDR to split large tables so the system can handle high-volume tables more efficiently during the copy process.

System Profile

Select the SAP client copy profile that controls what data is copied between the local clients.

SAP Client Copy Profiles Explained

Profile	Meaning	What it copies	Typical use
SAP_ALL	All client-specific data without change documents	Customising, user master, application data, master data, and transactional data, excluding change documents.	Full client copy where most client data is required.
SAP_APPL	Customising and application data without change documents	Customising and business application data, excluding change documents.	Functional test clients where application data is required.
SAP_APPX	SAP_APPL without authorisation profiles and roles	Customising and application data, excluding authorisation profiles and roles.	Application copy where target authorisations must remain controlled separately.
SAP_CUST	Customising	Client-dependent configuration and customising settings only.	Shell build or configuration-only client without application data.
SAP_CUSV	Customising and user variants	Customising settings and user variants.	Configuration copy where user variants are also required.
SAP_CUSX	Customising without authorisation profiles and roles	Customising only, excluding authorisation profiles and roles.	Configuration refresh where target authorisations must be preserved.
SAP_PROF	Only authorisation profiles and roles	Roles, profiles, and authorisation-related objects.	Security role alignment between clients.
SAP_UCSV	Customising, user master records, and user variants	Customising settings, user master data, and user variants.	Production-like lower clients without full transaction data.
SAP_UCUS	Customising and user master records	Customising and user master records, excluding user variants.	Client setup where users are required but variants are not needed.
SAP_UONL	User without authorisation profiles and roles	User master records without associated authorisation profiles and roles.	User copy where roles and profiles should be maintained separately in the target.

Important Guidance

For Local Client Copy, confirm that the target client is correctly prepared before execution. Use the number of parallel processes carefully and align it with available system resources. If large tables are expected, enable Split Large Tables to help control load and improve execution stability.