Systemcopy SAP ABAP

System Copy GuideSystem Copy for SAP Systems Based on SAP NetWeaver 7.0 SR3 ABAPTarget Audience System administrators Technology consultants

PUBLICDocument version: 1.5 2010-03-16

Document History

CAUTIONBefore you start the implementation, make sure you have the latest version of this document. You can find the latest version on SAP Service Marketplace http://service.sap.com/instguides.

The following table provides an overview on the most important document changes:Version Date Description1.5 2010-03-16 Update in Database-Specific System Copy: example for distributed or high availability

system corrected1.4 2009-12-08 Update in Database-Specific System Copy1.3 2009-09-09 Update in Oracle-Specific Procedure1.2 2009-03-12 Update in Constraints and Preparation for Table Splitting1.1 2009-01-09 DI-, EPC-, and EP-specific information updated

2/126 PUBLIC 2010-03-16

Table of Contents

Chapter 1 Homogeneous and Heterogeneous System Copy for SAP Systems Based on SAP NetWeaver 7.0 SR3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

1.1 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.2 Online Information from SAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.3 System Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.4 Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.5 Constraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Chapter 2 Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Chapter 3 Preparations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173.1 General Technical Preparations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173.2 Installing the Java Runtime Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Chapter 4 Database Independent System Copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214.1 System Copy Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224.2 Generating DDL Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254.3 Preparation for Table Splitting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264.4 Preparing the Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294.5 Exporting the Source System Using SAPinst . . . . . . . . . . . . . . . . . . . . . . . . . . 304.5.1 Running SAPinst on UNIX or Windows to Perform the Export . . . . . . . . . . . . 304.5.2 Running SAPinst on System i to Perform the Export . . . . . . . . . . . . . . . . . . . . 364.5.2.1 Preparing the Windows Host for the SAP System Installation . . . . . . . . . . . . . 364.5.2.2 Preparing a Windows User Account and System i User Profile . . . . . . . . . . . . . 374.5.2.3 Installing TMKSVR and Creating an Installation Share . . . . . . . . . . . . . . . . . . 394.5.2.4 Starting SAPinst on System i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414.5.3 Restarting R3load Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454.6 Setting Up the Target System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474.6.1 Installing the Target System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Chapter 5 Database-Specific System Copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515.1 Oracle-Specific Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

2010-03-16 PUBLIC 3/126

5.1.1 Generating the Control File Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545.1.2 Creating a Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585.1.2.1 Creating an Offline Backup Manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585.1.2.2 Creating an Offline or Online Backup with BR*Tools . . . . . . . . . . . . . . . . . . . 595.1.3 Preparing the Target System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595.1.4 Restoring the Database Files on the Target System Manually . . . . . . . . . . . . . 615.1.5 Restoring the Database Files on the Target System with BR*Tools . . . . . . . . . 625.2 SAP MaxDB-Specific Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635.3 MS SQL Server-Specific Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665.4 IBM DB2 for Linux, UNIX, and Windows Specific Procedures . . . . . . . . . . . . . 665.5 IBM DB2 for i5/OS Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695.6 IBM DB2 for z/OS Specific Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695.6.1 Step 1: Check Consistency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 715.6.2 Step 2: Stop and Restart the Source System . . . . . . . . . . . . . . . . . . . . . . . . . . . 715.6.3 Step 3: Run SQL Statements in the Source System . . . . . . . . . . . . . . . . . . . . . . 725.6.3.1 SQL Statement Number 01 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725.6.3.2 SQL Statement Number 02 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725.6.3.3 SQL Statement Number 03 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735.6.3.4 SQL Statement Number 04 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745.6.3.5 SQL Statement Number 05 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755.6.3.6 SQL Statement Number 06 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755.6.3.7 SQL Statement Number 07 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775.6.3.8 SQL Statement Number 08 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785.6.3.9 SQL Statement Number 09 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785.6.4 Step 4: Capturing View Definitions with DB2 V9 (if the Schema Name is to be

Changed) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 795.6.5 Step 5: Stop the Source System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 795.6.6 Step 6: Making Copies of Source Data Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805.6.7 Step 7: Creating the Target System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805.6.8 Step 8: Printing the Bootstrap Data Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805.6.9 Step 9a: Changing the Bootstrap Data Sets (BSDS) . . . . . . . . . . . . . . . . . . . . . . 815.6.10 Step 9b: Start the Target System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825.6.11 Step 9c: Creating a New STOGROUP Using the HLQ of the Target

System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 835.6.12 Step 9d: Stopping Index Spaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 835.6.13 Step 9e: Changing the User-Defined Indexes in the DB2 Catalog . . . . . . . . . . . 835.6.14 Step 9f: Restart the Index Spaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 835.6.15 Step 9g: Creating the Temporary Files for the DB2 Target System . . . . . . . . . . 84

4/126 PUBLIC 2010-03-16

5.6.16 Step 9h: Implementing HLQ of the Target System in the Work File Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

5.6.17 Step 9i: Adjusting the DDF Location Name and Port Number . . . . . . . . . . . . . 845.6.18 Step 10 (DB2 V8 and Lower): Changing the VCAT of the Target

System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 845.6.19 Step 10 (DB2 V9): Changing the VCAT of the Target System . . . . . . . . . . . . . . 865.6.20 Step 11 (DB2 V9): Changing the Schema of the Target System . . . . . . . . . . . . 865.6.21 Step 12: Adapting WLM Application Environments for DB2 Stored

Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Chapter 6 Follow-Up Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 896.1 Performing Follow-Up Activities in the Source System . . . . . . . . . . . . . . . . . . 896.2 Performing Follow-Up Activities in the Target System . . . . . . . . . . . . . . . . . . 896.2.1 Performing Follow-Up Activities for ABAP . . . . . . . . . . . . . . . . . . . . . . . . . . . 896.2.2 Performing Jobhead Correction after Homogeneous System Copy . . . . . . . . . 94

Chapter 7 Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 957.1 R3load Procedures Using the Migration Monitor . . . . . . . . . . . . . . . . . . . . . . . 957.1.1 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 957.1.2 Assigning DDL Files to Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1027.1.3 Defining Groups of Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1037.1.4 Processing Split Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1037.1.5 Starting the Migration Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1057.1.6 Output Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1107.1.7 Installing the Target System Using the Migration Monitor . . . . . . . . . . . . . . 1107.2 Using SAPinst GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1117.3 Interrupted Installation with SAPinst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1127.4 Performing a Remote Export Using SAPinst . . . . . . . . . . . . . . . . . . . . . . . . . . 1147.4.1 Performing a Remote Installation with SAPinst (Optional) . . . . . . . . . . . . . . 1157.4.2 Starting SAPinst GUI Separately (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . 116

2010-03-16 PUBLIC 5/126

This page is left blank for documents that are printed on both sides.

1 Homogeneous and Heterogeneous System Copy for SAP Systems Based on SAP NetWeaver 7.0 SR3

As of SAP NetWeaver 7.0, you can copy ABAP systems, ABAP+Java systems and Java systems in one run using either database-specific methods or database-independent methods.

1.1 Terminology Homogeneous System Copy

During the system copy you use the same operating system and database platform as the original system.

Heterogeneous System CopyDuring the system copy, you change either the operating system or the database system, or both. Heterogeneous system copy is a synonym for migration.

Source System and Target SystemThe SAP system containing the original database is called the source system and the system to which the database copy is to be imported is called the target system. Their SAP system names are abbreviated to SOURCE_SAPSID and TARGET_SAPSID (System i: source_ and target_). The terms source database and target database are also used in this description.

System CopyDuplication of an SAP system. Certain SAP parameters might change in a copy. When you perform a system copy, SAPinst installs all the instances again, but it uses a copy of the source system database to set up the database.

Database CopyDatabase-dependent part of the system copy.

PlaceholdersPlaceholders such as are used in commands. They are used in the same way as in the SAP system installation documentation. You must replace them with the values valid for your site.The following additional placeholders are used:

Placeholder Meaning How to find out SAP system ID System name of the source host Command hostname System name of the target host Command hostname


1.1 Terminology

2010-03-16 PUBLIC 7/126

Placeholder Meaning How to find out SAP system ID of the source system of the original system SAP system ID of the target system of the target system Database ID of the source system of the original system Database ID of the target system of the target system

1.2 Online Information from SAPMore information about system copy is online available as follows: SAP System Copy & Migration page at http://sdn.sap.com/irj/sdn/systemcopy. SAP OS/DB Migration page at http://service.sap.com/osdbmigration.

Additionally to the information contained on this page, check the SAP OS/DB Migration Planning Guide that is available in the Media Library.

SAP Note 82478CAUTIONOnly perform a system copy if you have experience in copying systems and good knowledge of the operating system, the database, and the ABAP Dictionary. Only perform a heterogeneous system copy if you are a certified system support consultant or a certified SAP Technical Consultant.NOTEIf you encounter problems during the system copy, create a customer message using the application area BC-INS-MIG.

1.3 System Architecture

1.4 RestrictionsThe target system installation consists of both the target database and target instances/application servers installations. For the scenarios below, the following holds: Only valid for: IBM DB2 for Linux and UNIX and Windows |

The option Deferred Table Creation is not supported for load-based system copies for SAP systems that are not based on SAP NetWeaver 7.0 SR3.End of: IBM DB2 for Linux and UNIX and Windows |

Refresh of the database is not supported. A refresh of the database means that only the database is loaded with the content of a database of a different system. As in this scenario no migration controller is invoked, this is not supported.

Copying the database only is not supported.


1.2 Online Information from SAP

8/126 PUBLIC 2010-03-16

Copying the central instance only is not supported. The migration controller deletes all dialog instances in the database, so the system is not complete any longer.

Reinstalling the central instance without the database is not supported. The migration controller deletes all dialog instances in the database, so the system is not complete any longer.

1.5 Constraints SAP does not support client transport as a system copy method. Transporting production clients

is not supported at all. You can use client transport for the initial setup of an SAP system infrastructure. This documentation does not cover the client copy procedure.

This documentation does not describe how to export and import a database with the installation tools for reorganization purposes. Use the appropriate tools for database reorganization, as SAP does not support this installation option.

If you have made modifications in your development system and want to copy your quality assurance or production system onto the development system, see SAP Note 130906.

This documentation describes how to copy data from one SAP system to another SAP system based on SAP NetWeaver Application Server. This documentation does not describe how to copy data from non-SAP systems to SAP systems.

If you want to convert a non-Unicode system to a Unicode system or perform the system copy of a Unicode system, see SAP Note 551344.

For the development of Java applications, we strongly recommend that you follow the rules mentioned below. Otherwise, we cannot guarantee that you can copy your Java engine later with the SAP tools to change your underlying operating system and/or database system.

SAP does not generally support all Data Archiving operations after a system copy.If you used Data Archiving in the source or in the target system, access to the created archive file(s) from the target system may not always be possible. For more information, see SAP Note 153433 and System Landscape Optimization at http://service.sap.com/slo.Access to archived files from the target system without a dedicated archive migration project is only supported in the following cases: Your system copy clones a source system for nonproductive purposes, only read-access to the

previously archived data is intended from the target system (no reloading), and you do not store archive files using ArchiveLink/CMS.You can either copy all archive files to file systems that are not shared between the source and the target system, or you arrange network access for appropriate archive file sharing.

The system copy is done to replace a productive system by a new productive system (for example, hardware migration), assuming that the target system did not exist before and the source system's operation is discontinued after the system copy.


1.5 Constraints

2010-03-16 PUBLIC 9/126

You must not change the system ID during system copy, but arrange for file access and/or ArchiveLink/CMS connectivity.

In all other cases, contact SAP SLO at http://service.sap.com/slo or [email protected].

When you perform a system copy, all software units or usage types in the source system are copied to the target system. This means that none of the usage types in the target system can be excluded from the system copy, nor can you select usage types.

Dos and Don'ts for system copy: Do:

Save configuration data and runtime data in the Java database only. If you absolutely need to save this data to the file system level, you must use the Software Deployment Manager (SDM) to save the data.

Follow the Open SQL standard. Make sure that all communication runs through the database pool.

Don't: Save any system and infrastructure-specific data in business objects. Use a pointer to the

central storage of such information, for example: SAP SystemID and SID (SAPSID =SID=system name) Host name IP addresses Services and Ports Logical destinations and logical system names Other technical infrastructure names

Use file system persistency. Set up dependencies between Java and ABAP.


1.5 Constraints

10/126 PUBLIC 2010-03-16

2 Planning

This section describes how to plan your system copy.You can apply the system copy for: Setting up system landscapes (where the SAP systems have different SAPSIDs). Creating systems for testing, demonstration, training, and standby. Depending on the purpose of

the system, it might be advisable to use the same SAP system ID, even though this prevents you from including the system in a system group for transports.Only valid for: Oracle |

NOTEYou cannot create standby systems with a system copy.

End of: Oracle |NOTEYou should perform upgrades in a test system first. This way you can identify customer-specific problems that might result from modifications.

NOTEYou can set up the SAP system infrastructure (development, quality assurance, and production system) without making a system copy as follows: Install all SAP systems, starting with the development system. Customize the development

system as described in the implementation documentation. Transport the client-dependent and client-independent data to the quality assurance and

production systems.However, if you do not follow this concept, you can also install a system, customize it and then perform a system copy.

When copying a system that contains production data it is important to choose the right moment for the copy. This could be a month-end or year-end closing.

CAUTIONDo not use NFS-mounted file systems because writing to NFS-mounted file systems might cause corrupted dumps.

Required Documentation Read the following SAP Note for up-to-date information:

2 Planning

2010-03-16 PUBLIC 11/126

SAP Note 1120872 (Homogeneous and Heterogeneous System Copy for SAP Systems Based on SAP NetWeaver 7.0 SR3)

The documentation System Copy for SAP Systems Based on SAP NetWeaver 7.0 SR3 only describes the export of the source system in detail.

For the installation of the target system, you also need the installation guide for your SAP application:SAP NetWeaver 7.0: Installation Guide SAP NetWeaver 7.0 SR3 ABAP on : at http://service.sap.com/installnw70 Installation SAP NetWeaver Systems .SAP ERP 6.0: Installation Guide SAP ERP 6.0 SR3 ABAP on : at http://service.sap.com/erp-inst SAP ERP 6.0 Installation .SAP CRM 5.0: Installation Guide SAP CRM 5.0 SR3 ABAP on : at http://service.sap.com/crm-inst SAP CRM 2005 CRM Core and Standalone Components .SAP SRM 5.0: Installation Guide SAP SRM 5.0 SR3 ABAP on : at http://service.sap.com/srm-inst Using SAP SRM Server 5.0 .SAP SCM 5.0: Installation Guide SAP SCM 5.0 SR3 ABAP on : at http://service.sap.com/instguides SAP Business Suite Applications SAP SCM SAP SCM Server Using SAP SCM 5.0 Server .

Required DVDs, Tools, and Other SoftwareMake sure that all required DVDs for the system copy are available: Required DVDs

Installation Master DVDNOTEThe DVD names are abbreviated.You can find the full names of all media shipped with SAP NetWeaver 7.0 in Media Information for SAP NetWeaver 7.0 at http://service.sap.com/installNW70.

Order the right version of the installation kit before starting the system copy.Make sure that the versions of the SAP system and the installation tools are the same on the target and source systems. Exceptions are only allowed if they are described in an SAP Note.

NOTEYou can operate several SAP systems on a single host without encountering any problems. Nevertheless, we recommend that you use a separate host for each system because an SAP system upgrade might depend on an OS upgrade. If the SAP systems are on separate hosts, you can upgrade them at different times.CAUTIONThe source system must be in a consistent state before you can copy it.

Check that you have the appropriate tool versions for your SAP kernel.

2 Planning

12/126 PUBLIC 2010-03-16

For a heterogeneous system copy you need to get a migration key by generating it at http://service.sap.com/migrationkey.

Creating A System Copy PlanCreate a plan to perform the system copy.1. Consider the downtime of the source system (for preparations and copying) when planning the

system copy.2. Perform a test run of the system copy. You can use the time taken by the test run to calculate the

system downtime: If your target system will replace your source system, try to perform a complete test run. This

means that the entire database is exported from the source system, transferred to the target system and imported there. System downtime is approximately equal to the total test time (that is, time for export, transport, and import).

If you do not want to replace your source system, a partial test run (export of the entire database or parts of it) can be sufficient to calculate the system downtime. The source system is only down for the time of the export.Calculating the system downtime is particularly important for very large databases (VLDB) or when tapes are being used. The test run is also to determine the amount of export data. Choose the best data transfer method (for example, FTP or tape). We recommend that you perform read/write actions only on local file systems.

3. Define a schedule for the test migration and the final migration.

Miscellaneous In the event of a major change in hardware configuration (for example, new machine type,

new hard disk configuration, new file system type), consult your SAP-authorized hardware partner.

Decide which system copy procedure you want to use: The database-independent procedure using SAP tools.

Use this method if database-specific methods are either not available or not suitable. For more information, see, Database-Independent System Copy [page 21].

NOTEFor a heterogeneous system copy, only the database-independent method is available.

The database-specific procedure using tools provided by the database vendorSome database vendors offer specific tools for copying a database. These tools let you: Restore a backup of one database (source database) in another one (target database)

(backup method) Unload the source database and load the data into the target databaseFor more information, see Database-Specific System Copy [page 51].

2 Planning

2010-03-16 PUBLIC 13/126

Choosing an SAP system IDYou can choose the new SAP system ID freely during a new installation.

CAUTIONTo meet the requirements of the Workbench Organizer, you must choose different SAP system IDs for different SAP systems.

SAP licenseOnce the installation is completed and the SAP system copy has been imported, you will require a new license key for the target system. The license key of the source system is not valid for this system. For more information about ordering and installing the SAP license, see http://help.sap.com/nw70 SAP NetWeaver 7.0 Library English SAP NetWeaver Library SAP NetWeaver by Key Capability Solution Life Cycle Management SAP Licenses .For more information about SAP license keys, see http://service.sap.com/licensekey.

Archiving filesData that has been archived in the source system (data that does not reside in the database but was moved to a different storage location using SAP Archive Management) must be made accessible in the target system. Adapt the file residence information in the target system. For more information, see http://help.sap.com/nw70 SAP NetWeaver 7.0 Library English SAP NetWeaver Library SAP NetWeaver by Key Capability Solution Life Cycle Management Data Archiving .Access to archive files is platform-independent.

Configuration analysis and hardware analysisYou need to determine the: Number of application servers Expected size of the database Additional disks or other hardware required Required memory

NOTESee the section on hardware and software requirements in the SAP system installation documentation to determine the system requirements.

These methods are not supported for all database systems. See the following table to check which copy methods are available for your database system:Database OS Platform Available MethodsSAP MaxDB UNIX Use one of the following:

System copy procedure on UNIX using R3loadFor more information, see System Copy Procedure [page 22].

System copy procedure for a homogeneous system copy onlyFor more information, see SAP MaxDB-specific procedure [page 63].

SAP MaxDB Windows Use one of the following: System copy procedure on Windows using R3load

2 Planning

14/126 PUBLIC 2010-03-16

Database OS Platform Available MethodsFor more information, see System Copy Procedure [page 22].

System copy procedure for a homogeneous system copy onlyFor more information, see SAP MaxDB-specific procedure [page 63].

IBM DB2 for i5/OS IBM System i Use one of the following: System copy procedure on System i using R3load

For more information, see Starting SAPinst on System i [page 41].

System i-specific procedure for a homogeneous system copy onlyFor more information, see IBM DB2 for I5/OS Procedure [page 69].

For more information, see SAP Note 585277.IBM DB2 for Linux, UNIX, and Windows

UNIX or Windows Use one of the following: Only valid for: UNIX |

System copy procedure on UNIX using R3loadFor more information, see System Copy Procedure [page 22].End of: UNIX |

Only valid for: Windows |System copy procedure on Windows using R3loadFor more information, see System Copy Procedure [page 22].End of: Windows |

The backup method of IBM DB2 for Linux, UNIX, and Windows is supported for SAP systems based on SAP NetWeaver 7.0 SR3.For more information, see IBM DB2 for Linux, UNIX, and Windows Specific Procedures [page 66].

IBM DB2 for z/OS IBM System z Use one of the following: Only valid for: UNIX |

System copy procedure on UNIX using R3loadFor more information, see System Copy Procedure [page 22].End of: UNIX |

Only valid for: Windows |System copy procedure on Windows using R3loadFor more information, see System Copy Procedure [page 22].End of: Windows |

Additional Information: For more information about the IBM DB2 for z/OS

specific procedure for a homogeneous system copy only, see IBM DB2 for z/OS Specific Procedure [page 69].

When R3ta is used to split tables, DELETE with WHERE is not performed if import errors occur in the target system.For more information, see SAP Note 778729.

Oracle UNIX Use one of the following: Only valid for: UNIX |

System copy procedure on UNIX using R3load

2 Planning

2010-03-16 PUBLIC 15/126

Database OS Platform Available MethodsFor more information, see System Copy Procedure [page 22].End of: UNIX |

R3load method with Export/Import MonitorsFor more information, see R3load Procedures Using the Migration Monitor [page 95].

Oracle-specific procedure for a homogeneous system copy onlyFor more information, see Oracle-Specific Procedure [page 52].

Oracle Windows Use one of the following: Only valid for: Windows |

System copy procedure on Windows using R3loadFor more information, see System Copy Procedure [page 22].End of: Windows |


Homogeneous system copy only: Oracle backup/restore methodFor more information, see Oracle-Specific Procedure [page 52] and SAP Note 676468.

MS SQL Server Windows Use one of the following: Only valid for: Windows |

System copy procedure on Windows using R3loadFor more information, see System Copy Procedure [page 22].End of: Windows |


Homogeneous system copy only: Backup/Restore or Detach/Attach MethodFor more information, see MS SQL Server-Specific Procedure [page 66] and SAP Notes 193816 and 151603.

2 Planning

16/126 PUBLIC 2010-03-16

3 Preparations

Before you start the system copy, you must perform the following preparation steps:

3.1 General Technical PreparationsProcedureTo make a consistent copy of the database, you need to prepare the source system and perform some subsequent actions on the target system. This is not necessary when performing a test run.The following describes important preparations. For more information about SAP system administration, see the SAP Online Documentation. Before you start a system copy, check the minimum kernel patch level required by the support

package level of the source system. It might be necessary to replace the SAP kernel delivered with the kernel DVD of the installation kit and installed during the installation of the target system by a newer kernel patch level before starting the target system. If you have to replace the delivered SAP kernel, you can do this after the installation of the central instance.

Before you start the export on your source system, check that your JAVA_HOME environment points to a valid JDK version.

No canceled or pending update requests should be in the system. Check this by choosing ToolsAdministration Monitor Update (transaction SM13).

If canceled or pending updates exist, you must update these again or delete them from all clients. You can see whether canceled or pending updates exist by checking if table VBDATA contains any entries.Find the canceled or open updates as follows:1. Call transaction SM13.2. Delete the default values for the client, user, and time.3. Choose all update requests.

If canceled or pending records exist, you must update these again or delete them. Check whether this action was successful using transaction SE16 for table VBDATA.

Set all released jobs from Released to Scheduled:Tools CCMS Background Processing Jobs - Overview and Administration (transaction SM37)

You also need to do this for jobs that must run periodically (see SAP Note 16083). Select all jobs (include start after event) as follows:

Job Released Scheduled

3 Preparations3.1 General Technical Preparations

2010-03-16 PUBLIC 17/126

Adapt the operation mode timetable to make sure that no switching of operating modes takes place while a system is being copied as follows:

Tools CCMS Configuration Operation mode calendar (transaction SM63) Write down the logical system names of all clients:

1. If you plan to overwrite an existing system with a system copy (for example, the source and target systems will both exist after the system copy), make sure you write down the logical system names of all clients in the system that will be overwritten (transaction SCC4).As the logical system names will be overwritten, in the event of differences, you must change them back to their original names (as they existed in the system that is overwritten) in the follow-on actions after the system copy.

2. If you create a new system with a system copy (that is, create an upgrade test system), make sure that the logical naming strategy for this new system is consistent with your existing logical system naming convention. If you are still planning your BI (formerly BW) system landscape, see SAP Note 184447.

3. If your system copy is used to replace hardware for the DB server, migrate to a different database system or operating system (that is, source system for the copy is the same as the copy target), no changes to logical system names are required.

Before the export, delete QCM tables from your system as follows:1. Before deleting you must always check

That the tables are consistent no restart log or conversion procedure termination must be displayed

That the data of the original table can be read If application programs that use the affected original table do not run correctly, do not

delete the QCM table yet.2. Call transaction SE14.3. Choose Extras Invalid temp. table

All QCM tables that can be deleted are displayed.4. Mark the tables and delete them.

FI customers: You can perform an additional consistency check by running the job SAPF190 before copying the source system, as well as after copying the target system, and then compare the results. Make sure that no customer data is changed in the meantime. You can do this as follows:

Accounting Financial Accounting General ledger Periodic Processing Closing Check/countComparison

FI customers: You can further check consistency by running the jobs RFUMSV00 (tax on sales/purchases), RAGITT01 (asset history sheet), RAZUGA01 (asset acquisitions), RAABGA01 (fixed asset retirements) before copying the source system, as well as after copying the target system, and then compare the results. Make sure that no customer data is changed in the meantime.

3 Preparations3.1 General Technical Preparations

18/126 PUBLIC 2010-03-16

CO customers: You can perform an additional consistency check by running the report group 1SIP before copying the source system, as well as after copying the target system, and then compare the results. Make sure that no customer data is changed in the meantime.

CAUTIONPrerequisites for an export:Before performing an export, make sure that no incremental conversion is in progress.To test if an incremental conversion is in progress, run transaction ICNV. If there are any table entries in table TICNV, an incremental conversion is in progress. In this case, you have the following options:1. Defer the migration until the incremental conversion has finished.2. Try to finish the incremental conversion by performing the following steps:

If the tables are in state For conversion or in state Done, delete the entries by choosing ControlDelete Entry .

If the tables are in any other state, you have to finish the incremental conversion. Choose Assistant and proceed according to the online documentation.CAUTIONHeterogeneous System Copy only: Before you start the export of your source system, make sure that the tables TATGPC and TATGPCA are empty. To do so, use your database utility and delete the contents of these tables with the following statements:DELETE from TATGPC DELETE from TATGPCANormally both tables are empty. If you do not delete the contents of these tables you will encounter problems while importing the data to your target system because of non NULL capable fields in these tables.

Prepare the system for SAPinst. For more information, see Installing the Java Runtime Environment [page 19].

3.2 Installing the Java Runtime EnvironmentYou need to prepare your system for SAPinst. This includes the installation of a Java Runtime Environment (JRE), which is required both for SAPinst and the SAPinst GUI.Only valid for: UNIX;Windows |

NOTEIf required, you can perform a remote installation using a standalone SAPinst GUI on a separate Windows or UNIX host. This lets you perform the installation on a remote host, controlling it with the SAPinst GUI from a local host. If you want to perform a remote installation, see Performing

3 Preparations3.2 Installing the Java Runtime Environment

2010-03-16 PUBLIC 19/126

a Remote Installation with SAPinst [page 115]. In this case, you need at least a JRE on the local host to start the SAPinst GUI there.

End of: UNIX;Windows |

Procedure1. Check the JRE versions that are released for SAP systems in the Product Availability Matrix (PAM):

1. Go to http://service.sap.com/pam.2. Only valid for: SAP NetWeaver |

On the right-hand panel, choose SAP NetWeaver SAP NetWeaver 7.0 (2004S) .End of: SAP NetWeaver |

3. Only valid for: SAP CRM;SAP ERP;SAP SCM;SAP SRM |On the right-hand panel, choose SAP Application Components .End of: SAP CRM;SAP ERP;SAP SCM;SAP SRM |

4. Choose tabstrip JSE Platforms.NOTEFor more information about the recommended JRE version for your operating system and about how to download it, see SAP Note 723909.

2. Make sure a valid JRE version is installed, as follows: If the JRE is not already installed, you need to download and install it. If the JRE is not already installed

Since the JRE is not part of the SAP shipment, you need to download and install it. The JRE is part of the JDK (Java Development Kit).

If the JRE is already installedCheck the installed version of the JRE by entering:java -version

NOTESAPinst checks environment variable SAPINST_JRE_HOME for a valid Java runtime environment.If SAPINST_JRE_HOME is not found, SAPinst also checks JAVA_HOME.

Only valid for: UNIX | Linux |

NOTEIf you use a Sun Java VM, you have to perform the following:Edit the configuration file $JAVA_HOME/jre/lib/security/java.security and replace entry securerandom.source=file:/dev/random with securerandom.source=file:/dev/urandom.

End of: UNIX | Linux |

3 Preparations3.2 Installing the Java Runtime Environment

20/126 PUBLIC 2010-03-16

4 Database Independent System Copy

With the SAP installation tool SAPinst, you can export and import your database in a database-independent format. SAPinst uses the R3load tool.R3load generates a database export of all SAP objects that are defined in the ABAP Dictionary and archives the configuration and components in the file system.

ConstraintsR3load and Jload Restrictions SAPinst generates a database dump of all SAP objects that are defined in the ABAP Dictionary

(R3load). Other objects are not exported by SAPinst. For a consistent database the SAP system must be shutdown (excluding the database!). The database

must still be running. R3load only: Changes to database objects that cannot be maintained in the ABAP Dictionary

(transaction SE14), such as the distribution of tables over several tablespaces or dbspaces, are lost after the system copy.

R3load only: Indexes longer than 18 characters are not allowed on the database to be exported.System Copy Tools Every installation service (dialog instance installation, for example) must have its own separate

installation directory whenever you start SAPinst. If the target system already exists and if you do not plan to perform an MCOD installation,

delete the database on the target system before the import according to the corresponding description in section Additional Information of the installation documentation for your SAP component.If the database configuration of your database is stored in the file system, we recommend you to back up these configuration files before deleting the database.

Splitting STR Files During the standard system copy process, all tables of the SAP system are grouped into packages,

whereby all tables with the same data class belong to the same package. The processing unit for one unload/load process is a package. The packages usually differ in number and size of contained tables, resulting in varying unload/load runtimes. The overall runtime can be reduced by creating packages of the same size, that is, creating packages with a similar processing time. You can achieve this by splitting the default packages (one package per data class) into more and smaller pieces.

4 Database Independent System Copy

2010-03-16 PUBLIC 21/126

There are several options of how to split packages. For a detailed description of the options, see the F1 help about the parameters prompted on the screen Split STR Files while running SAPinst to export the database. The options can be used separately or when using the new Java based splitting tool combined.

Splitting of STR Files is part of the Advanced Export Parameters and is disabled by default. If you select the splitting option and unless you did not already perform some tests, using the splitting tool parameters selected by SAPinst is a good starting point.

CAUTIONIf you want to split STR files, you must first create the EXT files for the target database system. You can find the EXT files in your export dump directory, subdirectory DB/, for example DB/ORA.

Process FlowFor UNIX, Windows, or System i, see System Copy Procedure [page 22].

4.1 System Copy ProcedureThis section describes the system copy procedure using R3load.

ProcedureProcess Flow on the Source System (Export)When performing the export you create a MIGRATION EXPORT CD image, which contains the data of the exported system, and which you use to install the target system.Follow the sequence of steps described in the process flows below for a: Central System Distributed System and High-Availability SystemCentral SystemTo perform the export for a central system, you need to proceed as follows on the central system host:1. Heterogeneous system copy: Generate the migration key at http://service.sap.com/

migrationkey. Enter the installation number of your source system when prompted.2. Perform the export on the central system host:

1. Only valid for: UNIX;Windows |Make sure that the QCM tables are deleted from your system.For more information, see General Technical Preparations [page 17].End of: UNIX;Windows |

2. Only valid for: IBM i5/OS |Prepare the Windows host for the SAP system installation.For more information, see Preparing the Windows Host for the SAP System Installation [page 36].End of: IBM i5/OS |

4 Database Independent System Copy4.1 System Copy Procedure

22/126 PUBLIC 2010-03-16

3. Only valid for: IBM i5/OS |Prepare a Windows user account and a System i user profile.For more information, see Preparing a Windows User Account and System i User Profile [page 37].End of: IBM i5/OS |

4. Only valid for: IBM i5/OS |Install TMKSVR and create an installation share.For more information, see Installing TMKSVR and Create an Installation Share [page 39].End of: IBM i5/OS |

5. Generate DDL statements.For more information, see Generating DDL Statements [page 25].

6. Prepare the system for table splitting (optional).For more information, see Preparation for Table Splitting [page 26].

7. Run SAPinst on UNIX, Windows, or System i to prepare the source system for parallel export or parallel import (optional).For more information, see Running SAPinst on UNIX or Windows to Perform the Export [page 30] or Running SAPinst on System i to Perform the Export [page 36].In SAPinst, choose the installation service Export Preparation.

8. Run SAPinst on UNIX, Windows, or System i to export the database instance and the central instance.In SAPinst, choose the installation service Database Instance Export.For more information, see Running SAPinst on UNIX or Windows to Perform the Export [page 30] or Running SAPinst on System i to Perform the Export [page 36].

NOTEIf R3load processes fail due to an error, solve the problem and perform a restart.For more information, see Restarting R3load Processes [page 45].

ResultYou have finished this part of the system copy. To complete the system copy, you set up the target system using SAPinst.For more information, see Setting Up the Target System Using SAPinst [page 47].

Distributed System or High-Availability SystemTo perform the export for a distributed system or a high-availability-system, you need to proceed as follows:1. Heterogeneous system copy only: Generate the migration key at http://service.sap.com/

migrationkey. Enter the installation number of your source system when prompted2. Perform the export on the database instance host:

1. Only valid for: UNIX;Windows |Make sure that the QCM tables are deleted from your system.


2010-03-16 PUBLIC 23/126

For more information, see General Technical Preparations [page 17].End of: UNIX;Windows |

2. Generate DDL statements.For more information, see Generating DDL statements [page 25].

3. Prepare the system for table splitting (optional).For more information, see Preparation for Table Splitting [page 26].

4. Run SAPinst on UNIX, Windows, or System i to prepare the source system for parallel export/import (optional). In SAPinst, choose the installation service Export Preparation.For more information, see Running SAPinst on UNIX or Windows to Perform the Export [page 30] or Running SAPist on System i to Perform the Export [page 36].

5. Run SAPinst on UNIX, Windows, or System i to export the database instance. In SAPinst, choose the installation service Database Instance Export.For more information, see Running SAPinst on UNIX or Windows to Perform the Export [page 30] or Running SAPinst on System i to Perform the Export [page 36].

NOTEIf R3load processes fail due to an error, solve the problem and perform a restart.For more information, see Restarting R3load Processes [page 45].CAUTIONIf your database instance is running on HP PA-Risc, you must proceed as described in SAP Note 884452.

ResultYou finished this part of the system copy. To complete the system copy, you set up the target system using SAPinst.For more information, see Setting Up the Target System Using SAPinst [page 47].


24/126 PUBLIC 2010-03-16

Overview on Export Options

Figure 1:

4.2 Generating DDL StatementsTo migrate nonstandard database objects, you need to generate DDL statements using the ABAP report SMIGR_CREATE_DDL.You must perform this procedure before starting SAPinst.

Procedure1. Log on to the system as a system administrator in a productive client.2. Call transaction SE38 and run the program SMIGR_CREATE_DDL.3. Select the target database. Depending on the database manufacturer, you might need to select the

database version. The value help supports you in selecting the database version. In general, you only should enter a database version that is available in the value help .

4. You are able to select Unicode Migration if you also wish to perform a Unicode system copy (from Unicode to Unicode) or a Unicode conversion (from non-Unicode to Unicode).

5. Specify an empty working directory to which the files generated by the report are to be written.6. If required, you can restrict the generation of DDL statements to specific table types or individual

tables.7. Execute the program.

The DDL statements are generated and are written to the specified directory.

4 Database Independent System Copy4.2 Generating DDL Statements

2010-03-16 PUBLIC 25/126

CAUTIONIf no database-specific objects exist in the database, no SQL files will be generated. As long as the report terminates with status successfully, this is not an error.

8. Before starting the export, the generated SQL files have to be copied from the specified directory to the directory of the export.

For additional database-specific information, see also SAP Note 888210.

4.3 Preparation for Table SplittingThe tool R3ta processes large tables. Instead of exporting/importing one table with one R3load process, the table is processed in, for example, 10 entities. Each entity can be processed by different R3load processes. The advantages of splitting the tables are: Large tables are processed in smaller packages. If the export or import of a table aborts with an

error, only the processing of the package where the error occurred has to be repeated and not for the complete table.

The export and import of one table can be performed in parallel by starting several R3load processes to work on some packages in parallel.

Prerequisites The export and import has to be performed with the Migration Monitor when the table splitting

feature is used. For the following databases, we recommend that you create an index on the column listed in the

hints file for the table you want to split before starting R3ta: DB2 for z/OS (Only create a temporary index if you want to perform an unsorted unload.) OracleFor more information, see paragraph Creating a Temporary Index.

Restrictions Only tables that are described in the SAP dictionary can be split. The following tables cannot be split:

DDNTF DDNTF_CONV_UC DDNTT DDNTT_CONV_UC DDLOG (is never copied, but created empty in the target system)

4 Database Independent System Copy4.3 Preparation for Table Splitting

26/126 PUBLIC 2010-03-16

Procedure1. Update the R3ta , R3ldctld and the dbslib.* in the kernel directory. You can find a

version of these files on the Installation Master DVD in the directory IM_//{UC/NUC}.

2. Create a file that contains lines of the form % for all tables to be split.CAUTIONThe tables listed in this file have to appear in alphabetical order!

3. Start SAPinst.4. Choose SAP NetWeaver System Copy Source System ABAP System Table Splitting Preparation .5. Specify SAPSID, password, the file that contains the split information, the export

directory, and the number of parallel R3ta jobs.CAUTIONThe specified path to the export directory must not contain blanks!

6. Continue with Next.CAUTIONWhen doing a code page conversion (non-Unicode Unicode; 4102 4103), make sure not to use a WHERE condition with the column PAGENO included. If the column PAGENO is included in the WHERE condition, repeat the table splitting - either with different splitting parameters or by defining a suitable column for this table using the R3ta_hints.txt.

7. Check in the export directory /ABAP/DATA if *.WHR files have been created for all tables that are to be split.If no *.WHR files could be produced for some of these tables, create fewer packages for these tables:1. Create a new, empty installation directory.2. Define a new, empty export dump directory .3. Run the Prepare Table Splitting service again and provide an input file that contains only the

missing tables with a lower number of packages for each defined table.If the *.WHR files have been created for the missing tables, merge these results with the results from the first Prepare Table Splitting run:1. Copy the *.WHR files from /ABAP/DATA to /ABAP/DATA.2. Add the lines from /ABAP/DATA/whr.txt to /ABAP/DATA/whr.txt.8. If required, create the temporary index on the source system's tables to be split. For more

information, see paragraph Creating a Temporary Index.Parallel data export of a table is supported by all database platforms but not parallel data import. When the target database platform does not support the parallel data import, the Migration Monitor has to


2010-03-16 PUBLIC 27/126

be configured in the way that the data import processes the packages are sequentially. For more information, see Processing Split Tables.

Using HintsWith the file R3ta_hints.txt, you can instruct R3ta to use specific columns of a table to create a WHERE condition. The file has to be located in the directory in which you start R3ta.With one line in the file R3ta_hints.txt, you specify the table name followed by one or more column names, separated by a blank. The columns have to be part of the primary key of the table. These specifications are used by R3ta to create the WHERE condition.A file R3ta_hints.txt with column hints for several tables is delivered with the Installation Master DVD. After the Table Splitting Preparation, make sure you select the Split predefined tables checkbox and add the R3ta_hints.txt file in the Split STR Files dialog box. If you want to modify this file, copy it from the directory /COMMON/INSTALL to the installation directory and adapt it according your requirements as soon as the Parameter Summary dialog appears and before starting the processing phase.

Creating a Temporary IndexOnly valid for: IBM DB2 for z/OS |IBM DB2 z/OS only: Create the corresponding temporary index on the database with database tools. Only create a temporary index if you want to perform an unsorted unload. This is the case when you use a DDLDB2.TPL file with no ORDER_BY_PKEY and the R3load does not overrule this setting. Which tables cannot be unloaded unsorted is described in SAP Note 954268.End of: IBM DB2 for z/OS |Only valid for: IBM DB2 for z/OS |

EXAMPLE1. Use the DEFER YES parameter to create the index.2. Afterwards, use the REBUILD INDEX job to speed up the index creation process.

End of: IBM DB2 for z/OS |Only valid for: Oracle |Oracle only: For further information and for alternatives, see SAP Note 960280.End of: Oracle |

For each table to be split, R3ta creates the following files to facilitate the creation of the temporary index:File Description_IDX.STR Contains the description of the temporary index; the default index name is

~IMG._IDX.TSK Contains the task to create the temporary index._IDX.cmd R3load command file for creating the temporary index.DRP__IDX.TSK Contains the task to drop the temporary index.DRP__IDX.cmd R3load command file for dropping the temporary index.


28/126 PUBLIC 2010-03-16

You can use the R3load cmd, STR and TSK files created by R3ta to create the index.1. Only valid for: IBM DB2 for i5/OS;IBM DB2 for Linux and UNIX and Windows;IBM DB2 for z/OS;MaxDB;MS SQL Server |

Make sure that you do not lock the table while creating the temporary index. Depending on your database platform it might be necessary to modify the create index statement in the DDL.TPL file.End of: IBM DB2 for i5/OS;IBM DB2 for Linux and UNIX and Windows;IBM DB2 for z/OS;MaxDB;MS SQL Server |

2. Only valid for: Oracle |Make sure that you do not lock the table while creating the temporary index. Depending on your database platform it might be necessary to modify the create index statement in the DDL.TPL file.Edit the file DDLORA.TPL and add the highlighted key words to the creind statement:creind: CREATE &unique&INDEX &ind name&ON &tab name&( /{ &fld name& /-, /} )TABLESPACE &tablespace& STORAGE (INITIAL &init&NEXT &next&MINEXTENTS &minext&MAXEXTENTS &maxext&PCTINCREASE &pctinc& )NOLOGGINGCOMPUTE STATISTICS PARALLELONLINE;End of: Oracle |

3. Call R3load as user adm with the following parameters:R3load dbcodepage i_IDX.cmd l _IDX.logIf your source system is a non-Unicode system, the dbcodepage is 1100. If your source system is a Unicode system, the dbcodepage is 4102 (Big Endian) or 4103 (Little Endian).

4.4 Preparing the ExportOptionally you can prepare the source system for the export using R3load and Jload, so as to enable parallel export/import. For this purpose you need to create certain files.The following steps are performed: Creating the export directory structure Creating database structure files (*.STR) Updating database statistics ()

4 Database Independent System Copy4.4 Preparing the Export

2010-03-16 PUBLIC 29/126

Size calculation for the target database (*.EXT,DBSIZE.XML)These export preparations are required, if: You want to build up the target system to the point where the database load starts, before the

export of the source system has finished. Export and import processes should run in parallel during the system copy process.Procedure1. You run SAPinst to perform the service Export Preparation.

For more information, see Running SAPinst on UNIX or Windows to Perform the Export [page 30].2. As soon as the export preparations have finished successfully, the complete export directory with

its structure and the generated files, which are required for building up the target system, have to be transferred to the target host. You can choose one of the following methods: Use the migration monitor with the FTP Copy Option to transfer the files to the target instance. Copy the export dump directory manually to the target host. The export dump directory can be shared and thus made accessible on the target host.In any case make sure that the dump directory and its subdirectories and files are accessible for user adm of the target system.

NOTEFor more information, see the documentation Migration Monitor Users Guide in the MIGMON.SAR archive on the SAP Installation Master DVD.

4.5 Exporting the Source System Using SAPinstHere you can find information about how to run SAPinst to perform the export on the source system: Running SAPinst on UNIX or Windows to Perform the Export [page 30] Running SAPinst on System i to Perform the Export [page 41]

4.5.1 Running SAPinst on UNIX or Windows to Perform the Export

This procedure tells you how to run SAPinst to export the database of your SAP system. SAPinst includes a SAPinst GUI and a GUI server, which both use Java.This section describes a standard export where SAPinst, SAPinst GUI, and the GUI server are running on the same host. If required, you can instead perform a remote system copy with SAPinst, where SAPinst GUI is running on a separate host from SAPinst and the GUI server. For more information, see Performing a Remote Installation with SAPinst [page 115].Note the following about SAPinst:

4 Database Independent System Copy4.5 Exporting the Source System Using SAPinst

30/126 PUBLIC 2010-03-16

When you start SAPinst, SAPinst GUI and the GUI server are also started. SAPinst GUI connects using a secure SSL connection to the GUI server and the GUI server connects to SAPinst.

Only valid for: UNIX | SAPinst normally creates the installation directory sapinst_instdir directly below the temporary

directory. SAPinst finds the temporary directory by checking the value of the environment variables TEMP, TMP, or TMPDIR. If no value is set for these variables, SAPinst uses /tmp as default installation directory.

The SAPinst Self-Extractor extracts the SAPinst executables to the temporary directory. These executables are deleted again after SAPinst has stopped running. If required, you can terminate SAPinst and the SAPinst Self-Extractor by pressing Ctrl+C .

End of: UNIX |Only valid for: Windows | SAPinst normally creates the installation directory sapinst_instdir, where it keeps its log files,

and which is located directly below the Program Files directory. If SAPinst is not able to create sapinst_instdir directly below the Program Files directory, SAPinst tries to create sapinst_instdir in the directory defined by the environment variable TEMP.

SAPinst creates a subdirectory for each installation service, called \ which is located below %ProgramFiles%\sapinst_instdir.

The SAPinst Self-Extractor extracts the executables to a temporary directory (TEMP, TMP, TMPDIR, or SystemRoot). These executables are deleted after SAPinst has stopped running.Directories with the name sapinst_exe.xxxxxx.xxxx sometimes remain in the temporary directory. You can safely delete them.In the temporary directory, you can also find the SAPinst Self-Extractor log file dev_selfex.out, which might be useful if an error occurs.

End of: Windows |

CAUTIONIf SAPinst cannot find a temporary directory, the installation terminates with the error FCO-00058.

Only valid for: Windows | If you want to terminate SAPinst and the SAPinst Self-Extractor, do one of the following:

Right-click the icon for the SAPinst output window located in the Windows tray and choose Exit.

Click the icon for the SAPinst output window located in the Windows tray and choose FileExit .

End of: Windows |


2010-03-16 PUBLIC 31/126

Prerequisites

CAUTIONMake sure that you shut down all SAP Application Servers before the export. The database must still be running. Otherwise, the target system might be inconsistent.

Only valid for: UNIX |You are logged on to your host as user root.End of: UNIX |Only valid for: Windows |You are logged on to your host as user with the required rights and privileges that authorize you to install the SAP system with the SAPinst tool. For more information, see section Required User Authorization for the Installation in your installation guide.End of: Windows |

Make available the Master Installation DVD. You need at least 60 MB of free space in the installation directory for each ABAP installation option,

and at least 130 MB of free space in the installation directory for each Java installation option. In addition, you need 60-200 MB free space for the SAPinst executables.Only valid for: UNIX |If you cannot provide 200 MB free space in the temporary directory, you can set one of the environment variables TEMP,TMP, or TMPDIR to another directory with 200 MB free space for the SAPinst executables.End of: UNIX |

Only valid for: Windows |Before starting the export steps on the central instance of the source system, make sure that you have at least the same amount of disk space available in \\SAPLOC\\\SDM\program as is used in \\SAPLOC\\\root\origin. During the export some archives are written to the program subdirectories and SAPinst aborts if there is not enough space.End of: Windows |

Only valid for: DB2 UDB for UNIX and Windows |Before you start the export of the existing SAP System, you have to download the current version of R3szchk at http://service.sap.com/patches and copy it to directory /usr/sap//SYS/exe/run/.End of: DB2 UDB for UNIX and Windows |

Only valid for: UNIX | Before starting the export, make sure that you have at least the same amount of disk space available

in /sapmnt///SDM/program as is used in /sapmnt///SDM/root/origin.During the export, some archives are written to the program subdirectories and SAPinst aborts if there is not enough space.


32/126 PUBLIC 2010-03-16

Make sure that the DISPLAY environment variable is set to :0.0, where is the host where the SAPinst GUI is displayed.

Make sure that your SAPINST_JRE_HOME environment variable is set to a valid Java Runtime Environment (JRE).

Only valid for: AIX |If the operating system is AIX 64-bit, make sure that the PATH variable points to a JDK/JRE for AIX 64-bit.End of: AIX |

End of: UNIX |For more information about SAPinst, see Using SAPinst GUI [page 111], Interrupted Installation with SAPinst [page 112], and Performing a Remote Export Using SAPinst [page 114].

Procedure1. Start SAPinst from the SAP Installation Master DVD as follows:

Only valid for: UNIX |Choose one of the following ways:End of: UNIX |Only valid for: UNIX | Using the default installation directory (recommended)

Enter the following commands:cd /IM_ ./sapinst SAPinst creates a directory called sapinst_instdir, which is the current working directory for your installation, below the temporary directory of your operating system.

Using an alternative installation directoryIf you want to use an alternative installation directory, set the environment variable TEMP, TMP, or TMPDIR.

Make sure that your operating system does not delete the contents of the temporary directory /tmp or the contents of the directories to which the variables TEMP, TMP, or TMPDIR point, for example, by using a crontab entry.

Make sure that your current working directory is not an IM_ directory belonging to another operating system.

EXAMPLEFor example, the following causes an error:$ cd /sapcd2/IM_HPUX_IA64$ /sapcd2/IM_HPUX_PARISC/sapinstTo correct this, enter the following:$ cd /sapcd2/IM_HPUX_PARISC $ /sapcd2/IM_HPUX_PARISC/sapinst

End of: UNIX |


2010-03-16 PUBLIC 33/126

Only valid for: Windows | Double-click sapinst.exe from the following path:

:\DATA_UNITS\IM_WINDOWS_SAPinst GUI normally starts automatically by displaying the Welcome screen.

End of: Windows |NOTEDuring the installation, the default ports 21200 and 21212 are used for communication between SAPinst, GUI server, and SAPinst GUI. SAPinst uses port 21200 to communicate with the GUI server. The GUI server uses port 21212 to communicate with SAPinst GUI. You get an error message if one of these ports is already in use by another service.In this case, open a command prompt and change to the required directory as follows::\IM_WINDOWS_.Enter the following command in a single line:sapinst.exe SAPINST_DIALOG_PORT= GUISERVER_DIALOG_PORT=For a list of all available SAPinst properties, enter the following command: sapinst p.

2. On the Welcome screen, choose Software Life-Cycle Options System Copy Source System Based on .

3. Select the corresponding system copy option from the tree structure according to the sequence of the process flow for the database-specific or the database-independent system copy procedure.For more information, see Database-Specific System Copy procedure [page 51] or Database-Independent System Copy [page 21].

CAUTIONMake sure that you choose the system copy options exactly in the order they appear for each system variant.

The following table provides an overview about the available installation options available for the export:Export Services for a Central SystemExport Service RemarksExport Preparation

NOTEYou do not perform this step if you use the database-specific method.

Optional step for preparing the export.SAPinst performs the following steps: Creates the export directory structure Creates database structure files (*.STR) Updates database statistics () Calculates the size of the target database

(*.EXT,DBSIZE.XML)Database Instance Export Mandatory step for database-independent system copy

procedure. SAPinst performs the following steps: Creates the export directory structure Creates database structure files (*.STR)


34/126 PUBLIC 2010-03-16

Export Service RemarksNOTEYou do not perform this step if you use the database-specific method.

Updates database statistics () Calculates the size of the target database

(*.EXT,DBSIZE.XML) Exports the ABAP database content

4. After you have selected the required option, choose Next.NOTEIf you generated SQL files with DDL statements (see Generating DDL Statements [page 25]), copy the generated files into the SAPinst installation directory as soon as it has been created by SAPinst. The installation directory will have been created as soon as the first input screen appears.

5. Follow the instructions in the SAPinst input dialogs and enter the required parameters.CAUTIONYou must choose Typical when performing a system copy with database tools.NOTEFor more information about input parameters in SAPinst, position the cursor on the parameter field and choose F1 .

6. Database-specific procedures only: On the screen SAP SystemDatabase Export choose option System Copy Method Use database specific tools .

After you have entered all required input parameters, SAPinst starts the export and displays the progress during the processing phase.

TroubleshootingIf an export process aborts due to a hardware failure (for example, file system full, power outage, operating system crash), you have to repeat the export of the complete package. Remove the dump files ., the TOC file .TOC, the log file .log and make sure that all tables in the TSK file .*TSK* have the status flag 'xeq' or 'err' set. If there is not enough disk space in the export directory, the R3load database export fails. You can

then find error messages in the log files SAP*.log.You can subsequently move the dump files that have been created from the file system in which the export directory is located to a different file system during the export. Currently there is no possibility to automatically distribute the export over different file systems.

If an error occurs during the dialog phase, SAPinst: Stops the export. Displays a dialog that informs you about the error.You can now directly view the log file by choosing View Logs.Finally you must abort the export with OK and try to solve the problem.

If an error occurs during the processing phase, SAPinst: Stops the export.


2010-03-16 PUBLIC 35/126

Displays a dialog that informs you about the error.You can now: Directly view the log file by choosing View Logs. Try to solve the problem. Continue the export by choosing Retry. Abort the export by choosing OK.

Only valid for: UNIX | System Copy - export on UNIX (especially for upgraded systems)

Symptom: Processes started as adm or ora OS users cannot create or open files in the installation directory.Reason: Only members of sapinst UNIX group can access the installation directory.This group is created first by SAPinst starting from NW 7.0 SR1.Solution: Associate adm and ora OS users with sapinst group manually if this association is missing.Verify /etc/group file and check if sapinst group exists and OS users are members of this group.If sapinst group does not exist yet, start SAPinst. SAPinst will create this group during startup before product catalog list will be displayed.Edit /etc/group file and associate OS users with sapinst group.Continue with the export.

End of: UNIX |

For more information, see Using SAPinst GUI [page 111], Interrupted Installation with SAPinst [page 112], and Performing a Remote Export Using SAPinst [page 114].Only valid for: IBM i5/OS |

4.5.2 Running SAPinst on System i to Perform the Export4.5.2.1 Preparing the Windows Host for the SAP System

InstallationThe Java-based SAPinst graphical user interface (SAPinst GUI) requires a Java Development Kit (Java 2 SDK, Standard Edition) with graphical capabilities (AWT, Swing). Since System i does not provide a graphical user interface, you must install the JDK on a Windows host to perform the installation with SAPinst.

PrerequisitesTo prepare the system for SAPinst and SAPinst GUI you need to do the following:


36/126 PUBLIC 2010-03-16

Necessary operating system versions: Windows NT/2000/2003/XP Check your Java Runtime Environment (JRE) on the host where SAPinst GUI runs, because the

JRE cannot be integrated into the SAPinst GUI executable for all platforms due to licensing issues. Set the system path if you install on Windows.ProcedureThe SAP J2EE Engine requires a Java Development Kit (Java 2 SDK, Standard Edition). Therefore, make sure a valid JDK version is installed on every host on which you want to install an SAP instance including the SAP J2EE Engine.For more information about the JDK versions that are released for the SAP Web Application Server, SAP components based on SAP Web AS and the SAP J2EE Engine, see http://service.sap.com/platforms Product Availability Matrix SAP NetWeaver SAP NetWeaver '04 JSE Platforms

NOTE JDK is not part of the SAP shipment. If necessary, you need to download and install it. To check the version of an already installed JDK, enter:

java -version If you have more than one Java Virtual Machine (JVM) installed on your system (for example,

you have two JDKs with different versions installed), make sure that the JAVA_HOME environment variable is set to the valid directory. Make sure that %JAVA_HOME%\bin is included in your system path.

Only valid for: IBM i5/OS | IBM i5/OS | IBM DB2 for i5/OS |

4.5.2.2 Preparing a Windows User Account and System i User Profile

For the installation you need to create a user account on your Windows installation host and a user profile on the System i you want to install.The following requirements apply: The System i user profile and the Windows user account must have the same name and password. Only valid for: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |

The System i user profile must have user class *SECOFR and all special authorities that belong to user QSECOFR.End of: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |

Only valid for: SAP SCM |The System i user profile must be the user QSECOFR.


2010-03-16 PUBLIC 37/126

NOTEThis is different to other installations on System i. For other installations, we recommended that you create user SAPINST or SAPINSTUSR. However for SCM, you need to use the user QSECOFR because the liveCache client software has to be installed by this special user.

End of: SAP SCM | The Windows user account must have administrator rights on the Windows installation host.ProcedureOnly valid for: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |

NOTEThe user name SAPINSTUSR and the password SAP are used as examples in the procedures. In former installation documentation, we used the user SAPINST. However, in future releases SAP has introduced a group called SAPINST on System i which conflicts with the previously recommended user SAPINST.

End of: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |

Windows:1. Create a local user.2. Only valid for: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |

In the field User name, enter your installation user name, for example, SAPINSTUSR.End of: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |

3. Only valid for: SAP SCM |In the field User name, enter your installation user name QSECOFR.End of: SAP SCM |

4. Only valid for: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |In the fields Password and Confirm password, enter the password SAP.End of: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |

5. Only valid for: SAP SCM |In the fields Password and Confirm password, enter the password of the user QSECOFR on your System i.End of: SAP SCM |

6. Deselect User must change password at next logon.7. Only valid for: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |

Assign the new user SAPINSTUSR to the group Administrators.End of: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |

8. Only valid for: SAP SCM |Assign the new user QSECOFR to the group Administrators.End of: SAP SCM |

System i:Only valid for: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |Enter the command CRTUSRPRF USRPRF(SAPINSTUSR) PASSWORD(SAP) USRCLS(*SECOFR) TEXT('Test User for SAP Installation') SPCAUT(*USRCLS) LANGID(ENU) CNTRYID(US) CCSID(500).End of: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |


38/126 PUBLIC 2010-03-16

Only valid for: SAP SCM |To change the user QSECOFR, enter the command CRTUSRPRF USRPRF(QSECOFR) LANGID(ENU) CNTRYID(US) CCSID(500). After the installation, you can revert the user profile QSECOFR back to the old values.End of: SAP SCM |

CAUTIONYou should not set the system variable QIBM_PASE_CCSID. You should leave this variable empty!

End of: IBM i5/OS | IBM i5/OS | IBM DB2 for i5/OS |Only valid for: IBM i5/OS | IBM i5/OS | IBM DB2 for i5/OS |

4.5.2.3 Installing TMKSVR and Creating an Installation ShareThe TMKSVR is the interface between System i and Windows for the installation with SAPinst. SAPinst is running on Windows, but has to install the product on System i. This means that all actions required for System i are initiated remotely on Windows but executed locally using the TMKSVR. The communication is done using TCP/IP.In addition, an installation share on the System i host needs to be created and mapped to the Windows installation host, which is done automatically by the TMKSVR.The TMKSVR has to be installed and an installation share has to be created on all System i hosts where instances of an SAP system should be installed.

Prerequisites An FTP server running on System i You must prepare a user. For more information about how users are prepared, see Preparing a Windows

User Account and System i User Profile [page 37]. The Installation Master DVD must be inserted in the DVD drive of your Windows host. Make sure there is no system variable LANG defining a LOCAL. Otherwise, code page problems might

prevent TMKSVR processes from starting.

Procedure1. Log on to your Windows host as the installation user. For more information, see Preparing a Windows

User Account and System i User Profile [page 37].Only valid for: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |

NOTEThis user must have the same user ID and password as the user that you are using for the installation on System i (a user with administrator rights similar to QSECOFR).

End of: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |


2010-03-16 PUBLIC 39/126

Only valid for: SAP SCM |NOTEThis user must have the same user ID and password as the user that you are using for the installation on System i. For SCM, this user must be QSECOFR).

End of: SAP SCM |2. Run SETUP.EXE from the directory IM_OS400_PPC64\TMKSVR on the DVD containing the

installation package. You can start the setup program by double-clicking on it in the Windows Explorer.The following dialog box appears:

Only valid for: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |

Figure 2: End of: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |

Only valid for: SAP SCM |

Figure 3: End of: SAP SCM |

3. Enter the following values:


40/126 PUBLIC 2010-03-16

System i Hostname:Enter the name of the System i host where you want to install TMKSVR.

Only valid for: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |System i Administrator (QSECOFR or similar):Enter the System i user. For more information, see Preparing a Windows User Account and System i User Profile [page 37].End of: SAP CRM;SAP ERP;SAP NetWeaver;SAP SRM |

Only valid for: SAP SCM |System i Administrator (QSECOFR):Enter the System i user. For more information, see Preparing a Windows User Account and System i User Profile [page 37].End of: SAP SCM |

TMKSVR instance number:Leave the value at 0.

TMKSVR Instance Port (also referred to as the Dispatcher Port):Leave the value at 59975, if possible. Only change this port number if you encounter problems during installation because the port is in use.

ResultThe installation uses FTP to install and starts the TMKSVR on System i. During installation, a library named TMKSVR is created, with being the instance number (for example, TMKSVR00).A NetServer share named ROOTBIN is created on the System i host. You can map the share now to your Windows PC or let SAPinst map it during the installation.For more information, see the documentation INSTALL.PDF on the DVD in directory IM_OS400_PPC64\TMKSVR.End of: IBM i5/OS | IBM i5/OS | IBM DB2 for i5/OS |Only valid for: IBM i5/OS |

4.5.2.4 Starting SAPinst on System iCAUTIONThis section refers to installation of an instance, which is a synonym for export an SAP system.

This procedure tells you how to run SAPinst to install one or more SAP instances. It describes an installation where SAPinst GUI and SAPinst server are running on the same Windows host.SAPinst creates the installation directory \usr\sap\sapinst on System i.

PrerequisitesCAUTIONMake sure that you shut down all SAP Application Servers before the export. The database must still be running. Otherwise, the target system might be inconsistent.


2010-03-16 PUBLIC 41/126

TMKSVR is up and running: WRKACTJOB SBS (TMKSVR00) (there must be a DISPATCH job). For more information, see Installing TMKSVR and Creating an Installation Share [page 39].

The Windows host is set up. For more information, see Preparing the Windows Host for the SAP System Installation [page 36].

The users required for the installation are prepared. For more information, see Preparing a Windows User Account and System i User Profile [page 37].

Make sure that the JAVA_HOME environment variable is set correctly on your Windows host.Procedure1. Log on to the Windows host as the installation user. For more information, see Preparing a Windows

User Account and System i User Profile [page 37].2. Start SAPinst from the SAP Installation Master DVD in one of the following ways:

If using the default installation directory (recommended) by double-clicking sapinst.exe from the following path::\IM_OS400_PPC64

NOTE During the installation, the default ports SAPinst 21212 and 21213 are used for

communication between SAPinst, GUI server and SAPinst GUI. SAPinst uses port 21200 to communicate with the GUI server. You get an error message if one of these ports is already in use by another service. In this case, open a command prompt and change to the required directory as follows::\IM_OS400_PPC64

Enter the following command in a single line:sapinst.exe SAPINST_DIALOG_PORT= GUISERVER_DIALOG_PORT= For a list of all available SAPinst properties, enter the following command: sapinst

-p3. The SAPinst/TMKSVR Session Parameters dialog box appears and prompts you for the target System

i parameters. Enter your values.


42/126 PUBLIC 2010-03-16

Figure 4:

The SAPinst GUI now starts automatically by displaying the Welcome screen.4. In the Welcome screen, choose Software Life-Cycle Options System Copy Source System

Based on .5. Select the corresponding installation service from the tree structure according to the sequence of

the process flow for one of the following precedures: Database-Specific System Copy [page 51] Database-Independent System Copy [page 21]

CAUTIONMake sure that you choose the installation services exactly in the order they appear for each system variant.

6. The following table provides an overview about the available installation services available for a: Central system Distributed system or high-availability systemExport Services for a Central SystemExport Service RemarksExport Preparation


Optional step for preparing the export.SAPinst performs the following steps: Creates the export directory structure Creates database structure files (*.STR) Updates database statistics () Calculates the size of the target database

(*.EXT,DBSIZE.XML)


2010-03-16 PUBLIC 43/126

Export Service RemarksDatabase Instance Export


Mandatory step for database-independent system copy procedure. SAPinst performs the following steps: Creates the export directory structure Creates database structure files (*.STR) Updates database statistics () Calculates the size of the target database

(*.EXT,DBSIZE.XML) Exports the ABAP database content

Export Services for a Distributed System or a High-Availability SystemExport Service RemarksExport Preparation


Optional step for the database-independent system copy procedure to prepare the export.You need to perform this step on the database instance host.SAPinst performs the following steps: Creates the export directory structure Creates database structure files (*.STR) Updates database statistics() Calculates the size of the target database

(*.EXT,DBSIZE.XML)Database Instance Export

NOTE You do not perform this step if you

use the database-specific method.

Mandatory step for the database-independent system copy procedure.You need to perform this step on the database instance host.SAPinst performs the following steps: Creates the export directory structure with label files Creates database structure files (*STR) Updates database statistics Calculates the size of the target database

(*EXT,DBSIZE.XML) Exports the database content

7. After you have selected the required installation service, choose Next.8. Choose Next

NOTEIf you generated SQL files with DDL statements (see Generating DLL Statements [page 25]), copy the generated files into the SAPinst installation directory as soon as it has been created by SAPinst:1. Choose Database and Central Instance Export2. Choose Next.3. The installation directory has been created as soon as the first input screen appears.

9. Follow the instructions in the SAPinst input dialogs and enter the required parameters.CAUTIONYou must choose Typical when performing a system copy with database tools.


44/126 PUBLIC 2010-03-16

NOTEFor more information about input parameters in SAPinst, position the cursor on the parameter field and choose F1 .

After you have entered all required input parameters, SAPinst starts the installation and displays the progress of the installation.When the installation has successfully completed, the screen Finished installation is displayed.

TroubleshootingCAUTIONIf an export process aborts due to a hardware failure (for exa

Documents

Systemcopy SAP ABAP