How to System Copy ABAP and JAVA

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com © 2008 SAP AG 1

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.



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



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>



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



Choose Next

8 For the parameter mode choose Typical.

Choose Next

9 Fill in your profile directory.



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.



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)



Choose Next

14

Choose Start



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



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



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



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:


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.



Database Instance


2 Install the Database Instance.



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)



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!



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


2 Install the Central Instance.



System Copy

Oracle

Target System

Distributed system

…………………..Based on AS ABAP and AS JAVA

……………………..Central Instance



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.



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



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.

Documents

How to System Copy ABAP and JAVA