How to… System Copy for

ABAP+Java

Applies to:
SAP NetWeaver 7.0 SR2 ABAP+Java on Oracle+Linux.

Summary
This is a how-to document for performing a homogeneous system copy for a ABAP with a JAVA-add in. It
describes the steps for which need to be done on the source system and on the target system.
Author(s): Han Schuitemaker
Company: Uphantis B.V.
Created on: 10 April 2008

Author Bio

Han Schuitemaker is a certified Senior Technology Consultant. Han has nearly 10 years of
experience with SAP. He is currently working for Uphantis B.V., a company with a focus on
Applied Technology.

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 1
 How to… System Copy for ABAP+Java

Table of Contents
Applies to: ...........................................................................................................................................................1
Summary.............................................................................................................................................................1
Author Bio ...........................................................................................................................................................1
Table of Contents ...............................................................................................................................................2
Preparations .......................................................................................................................................................3
General Information ........................................................................................................................................3
Documentation ................................................................................................................................................3
DVDs ...............................................................................................................................................................3
Source System ...................................................................................................................................................3
Target System ..................................................................................................................................................12
Preperations..................................................................................................................................................12
Central Service Instance ...............................................................................................................................12
Database Instance ........................................................................................................................................13
Central Instance ............................................................................................................................................15
Follow-Up Activities ..........................................................................................................................................16
ABAP.............................................................................................................................................................16
JAVA .............................................................................................................................................................17
Related Content................................................................................................................................................17
Copyright...........................................................................................................................................................18

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 2
 How to… System Copy for ABAP+Java

Preparations

General Information
This document is focused on the JAVA part of the homogeneous system copy. It doesn’t describe al the
necessary steps for the ABAP part. I assume that this is more or less well-know.

Documentation
I have used the following documentation:
• System Copy for SAP Systems Based on SAP NetWeaver 7.0 SR2 ABAP+Java.pdf
• Note 970518 - Hom. Het.System Copy SAP NetWeaver 7.0 (2004s) SR2.pdf
• Note 784118 - System Copy Java Tools
• Note 831812 - Config Tool shows incorrect parameters after System CopyBullet 1
• OraBRCopy.pdf

DVDs
You need to have the following DVDs:
• Installation Master
• Kernel Unicode
• Kernel NonUnicode
• JAVA Components
• Oracle Client
Note: you only have to use the NonUnicode DVD if you have a non unicode system.

Source System
This section describes the action which have to be taken on the Source System. How to create the
MIGRATION EXPORT CD image. This image contains the data of the exported system, and which
you use to install the target system.

1 Create an offline backup of the source database, preferably a backup on disk.

2 Create an installation directory:
mkdir /usr/sap/trans/systemcopy (or whatever you like)
chmod 777 systemcopy
Note: Preferably the target system should also be able to access this directory.
3 Download ORABRCOPY.SAR according to note 784118 and copy the archive to
the installation directory.
Unarchive ORABRCOPY.SAR
SAPCAR -xvf ORABRCOPY_2-20001410.SAR
4 Execute the OraBRCopy Tool
Logon as the ora user on the source system
./ora_br_copy.sh -generateFiles -targetSid <TARGET_DBSID> -tnsAlias
<SOURCE_DBSID> -password <system’s password>

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 3
 How to… System Copy for ABAP+Java

As a result of this action you will find three additional files in your installation
directory:
- CONTROL.SQL
- CONTROL.TRC
- ora_br_copy.log
5 Extract the SAP installation software from the Installation_Master DVD
Logon as a root user
cd /usr/sap/trans/systemcopy (the directory you have created at step 2)
<path of the Installation_Master DVD>/sapinst –extract
6 Start SAPinst
./sapinst SAPINST_USE_HOSTNAME=<central instance hostname> <path of the
Installation_Master DVD>/product.catalog
7 Choose the following path:
Additional Software Life-Cycle Tasks
System Copy
Oracle
Source System
Distributed system
Central Instance Export

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 4
 How to… System Copy for ABAP+Java

Choose Next
8 For the parameter mode choose Typical.

Choose Next
9 Fill in your profile directory.

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 5
 How to… System Copy for ABAP+Java

Choose Next
10 In this step I received this error message:

Choose OK
Note: I’m not sure if this is a general issue or just an issue on our site.
10 The profile directory screen appeared again.

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 6
 How to… System Copy for ABAP+Java

Choose Next
11 Fill in the Database Parameters of the source database, DBSID and Host.

Choose Next
12 Mark the Use database specific tools.

Choose Next
13 Fill in the location where you want to store your export file.
(e.g. /usr/sap/trans/systemcopy)

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 7
 How to… System Copy for ABAP+Java

Choose Next
14

Choose Start

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 8
 How to… System Copy for ABAP+Java

15

16 In the fase Archive Adobe Document Service data, the export stopped.

Choose View Log

The error was an permission denied error, while unarchiving a file. The solution for

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 9
 How to… System Copy for ABAP+Java

this problem was as follow:

/usr/sap/trans/systemcopy/SAPCAR -c -v -g -i -C
/usr/sap/<SID>/SYS/global/AdobeDocumentServices/TrustManagerService -f
/usr/sap/trans/systemcopy/JAVA/APPS/ADS/FONTS.ADS.SAR .
chown –R <sid>adm:sapsys /usr/sap/trans/systemcopy/JAVA/APPS/ADS
Note: Again, I’m not sure if this is a general issue or just an issue on our site.
17 After fixing the issue and closing the log file you can proceed.

Choose Retry
18

Choose OK

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 10
 How to… System Copy for ABAP+Java

The export has finished successfully and now you can start with the target system.

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 11
 How to… System Copy for ABAP+Java

Target System
This section describes the actions which have to be taken on the Target System. How to import the
MIGRATION EXPORT CD image. As I already mentioned I focus on the JAVA part. The document describes
the Installation of a new target system. If you want to refresh the target system, just make a copy of your
profiles, environment settings, ORA sqlnet files etc.

Preperations

1 If necessary, make a copy of your profiles in the SAP profile directory, a copy of the
environment settings of your sidadm and oracle user and your ORA sqlnet files.
Note: Maybe you want to save some other files as well.
2 Clean your target system. Delete your oracle datafiles as you would normally do
with a homogeneous system copy.

Central Service Instance

1 Create an installation directory, extract the SAP installation and start the
installation.
2 Install the Central Service Instance.
Choose the following path:
Additional Software Life-Cycle Tasks
System Copy
Oracle
Target System
Distributed system
Based on AS ABAP and AS JAVA
Central Service Instance (SCS)

Choose next and follow the instructions on the screens.

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 12
 How to… System Copy for ABAP+Java

Database Instance

1 Create an installation directory, extract the SAP installation and start the
installation.
2 Install the Database Instance.
Choose the following path:
Additional Software Life-Cycle Tasks
System Copy
Oracle
Target System
Distributed system
Based on AS ABAP and AS JAVA
Database Instance

Choose Next and follow the instructions on the screen.

3 On the database installation method selection screen choose Homogeneous
System Copy (Backup/Restore)

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 13
 How to… System Copy for ABAP+Java

Choose Next
4 The installation stops with the following error message:

Follow Note 970518 - Hom./Het.System Copy SAP NetWeaver 7.0 (2004s) SR2
-------------------------<D023322, 23/JAN/07>-----------------------
Error during system copy with Oracle-specific procedure
vi control.xml
find "update ORACHECK_PAR" and delete row "row.createDb = false;"
Restart the installation
5 On the database schema parameters select screen, fill in the schema of your
source system!

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 14
 How to… System Copy for ABAP+Java

Choose Next
6 Now you have to restore your backup. Pay attention to the file permissions!
Copy the control file which is created on the source system to the database
installation directory.

Choose OK

Central Instance

1 Create an installation directory, extract the SAP installation and start the
installation.
2 Install the Central Instance.
Choose the following path:
Additional Software Life-Cycle Tasks
System Copy
Oracle
Target System
Distributed system
…………………..Based on AS ABAP and AS JAVA
……………………..Central Instance

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 15
 How to… System Copy for ABAP+Java

Choose Next and follow the instructions on the screen.

3 On the Software Package Request select screen, fill in the path of the export of the
source system.

e.g. /usr/sap/trans/systemcopy,
Choose OK

Follow-Up Activities

ABAP

1 Perform follow-up activities in the target system as you normally would do after a
Homogeneous System Copy.

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 16
 How to… System Copy for ABAP+Java

JAVA
The Java engine is not started automatically. After the target system has been installed and
thefollow-up activities have been performed, you have to start the Java engine manually.

1 Follow Note 831812 - Config Tool shows incorrect parameters after System Copy
/usr/sap/<SID>/DVEBMGSxx/j2ee/configtool
./ offlinecfgeditor.sh

Choose Yes
2 Restart the system JAVA will be started now.

You have to perform the following activities for specific usage types (EP, XI etc) or software units of the
copied SAP system as mentioned in the system copy guide.

Related Content
Creating a Homogeneous System Copy
System Copy for SAP Systems Based on SAP NetWeaver 2004s SR2 ABAP+Java
System Copy and Migration

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 17
 How to… System Copy for ABAP+Java

Copyright
© 2008 SAP AG. All rights reserved.
No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG.
The information contained herein may be changed without prior notice.
Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors.
Microsoft, Windows, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation.
IBM, DB2, DB2 Universal Database, OS/2, Parallel Sysplex, MVS/ESA, AIX, S/390, AS/400, OS/390, OS/400, iSeries, pSeries, xSeries,
zSeries, System i, System i5, System p, System p5, System x, System z, System z9, z/OS, AFP, Intelligent Miner, WebSphere,
Netfinity, Tivoli, Informix, i5/OS, POWER, POWER5, POWER5+, OpenPower and PowerPC are trademarks or registered trademarks of
IBM Corporation.
Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe Systems
Incorporated in the United States and/or other countries.
Oracle is a registered trademark of Oracle Corporation.
UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group.
Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or registered trademarks of
Citrix Systems, Inc.
HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C®, World Wide Web Consortium, Massachusetts
Institute of Technology.
Java is a registered trademark of Sun Microsystems, Inc.
JavaScript is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by
Netscape.
MaxDB is a trademark of MySQL AB, Sweden.
SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP NetWeaver, and other SAP products and services mentioned herein as well as their
respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All
other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves
informational purposes only. National product specifications may vary.
These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP
Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or
omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the
express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an
additional warranty.
These materials are provided “as is” without a warranty of any kind, either express or implied, including but not limited to, the implied
warranties of merchantability, fitness for a particular purpose, or non-infringement.
SAP shall not be liable for damages of any kind including without limitation direct, special, indirect, or consequential damages that may
result from the use of these materials.
SAP does not warrant the accuracy or completeness of the information, text, graphics, links or other items contained within these
materials. SAP has no control over the information that you may access through the use of hot links contained in these materials and
does not endorse your use of third party web pages nor provide any warranty whatsoever relating to third party web pages.
Any software coding and/or code lines/strings (“Code”) included in this documentation are only examples and are not intended to be
used in a productive system environment. The Code is only intended better explain and visualize the syntax and phrasing rules of
certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors
or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or grossly negligent.

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 18