Hana Migration Guides
Hana Migration Guides
Dino Quintero
Damon Bull
Vinicius Cosmo Cardoso
Cleiton Freire
Eric Kass
Redpaper
IBM Redbooks
March 2020
REDP-5571-00
Note: Before using this information and the product it supports, read the information in “Notices” on page v.
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .v
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Authors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Now you can become a published author, too! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Comments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Stay connected to IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Chapter 2. Migrating SAP systems from a non-SAP HANA DB to an SAP HANA on IBM
Power Systems DB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.1 The SAP Software Provisioning Manager tool and the R3load and Jload processes. . . 8
2.1.1 The SAP Software Provisioning Manager tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.1.2 The R3load and Jload processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.1.3 Advanced migration techniques for Software Provisioning Manager and R3load and
Jload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.1.4 Database Migration Option tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Online resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Help from IBM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
This information was developed for products and services offered in the US. This material might be available
from IBM in other languages. However, you may be required to own a copy of the product or product version in
that language in order to access it.
IBM may not offer the products, services, or features discussed in this document in other countries. Consult
your local IBM representative for information on the products and services currently available in your area. Any
reference to an IBM product, program, or service is not intended to state or imply that only that IBM product,
program, or service may be used. Any functionally equivalent product, program, or service that does not
infringe any IBM intellectual property right may be used instead. However, it is the user’s responsibility to
evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The
furnishing of this document does not grant you any license to these patents. You can send license inquiries, in
writing, to:
IBM Director of Licensing, IBM Corporation, North Castle Drive, MD-NC119, Armonk, NY 10504-1785, US
This information could include technical inaccuracies or typographical errors. Changes are periodically made
to the information herein; these changes will be incorporated in new editions of the publication. IBM may make
improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time
without notice.
Any references in this information to non-IBM websites are provided for convenience only and do not in any
manner serve as an endorsement of those websites. The materials at those websites are not part of the
materials for this IBM product and use of those websites is at your own risk.
IBM may use or distribute any of the information you provide in any way it believes appropriate without
incurring any obligation to you.
The performance data and client examples cited are presented for illustrative purposes only. Actual
performance results may vary depending on specific configurations and operating conditions.
Information concerning non-IBM products was obtained from the suppliers of those products, their published
announcements or other publicly available sources. IBM has not tested those products and cannot confirm the
accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the
capabilities of non-IBM products should be addressed to the suppliers of those products.
Statements regarding IBM’s future direction or intent are subject to change or withdrawal without notice, and
represent goals and objectives only.
This information contains examples of data and reports used in daily business operations. To illustrate them
as completely as possible, the examples include the names of individuals, companies, brands, and products.
All of these names are fictitious and any similarity to actual people or business enterprises is entirely
coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrate programming
techniques on various operating platforms. You may copy, modify, and distribute these sample programs in
any form without payment to IBM, for the purposes of developing, using, marketing or distributing application
programs conforming to the application programming interface for the operating platform for which the sample
programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore,
cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are
provided “AS IS”, without warranty of any kind. IBM shall not be liable for any damages arising out of your use
of the sample programs.
The following terms are trademarks or registered trademarks of International Business Machines Corporation,
and might also be trademarks or registered trademarks in other countries.
Redbooks (logo) ® Db2® Redbooks®
AIX® IBM®
DB2® IBM Cloud™
The registered trademark Linux® is used pursuant to a sublicense from the Linux Foundation, the exclusive
licensee of Linus Torvalds, owner of the mark on a worldwide basis.
Microsoft, Windows, and the Windows logo are trademarks of Microsoft Corporation in the United States,
other countries, or both.
Java, and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its
affiliates.
Other company, product, or service names may be trademarks or service marks of others.
This IBM® Redpaper publication provides SAP HANA platform migration information and
details for successful planning for migration to IBM Power Systems servers.
This publication addresses topics for sellers, IT architects, IT specialists, and anyone who
wants to migrate and manage SAP workloads on Power Systems servers. Moreover, this
guide provides documentation to transfer how-to skills to the technical teams, and it provides
solution guidance to the sales team. This publication complements documentation that is
available at IBM Knowledge Center, and it aligns with educational materials that are provided
by IBM Systems.
Authors
This paper was produced in close collaboration with the IBM SAP International Competence
Center (ISICC) in Walldorf, SAP Headquarters in Germany, and IBM Redbooks®.
Damon Bull is a Senior SAP Software Performance Engineer who has worked with different
SAP versions from 2.2F onward. His focus is on SAP performance, and he has conducted
and published over 50 SAP benchmarks over the last 25 years. Damon has experience with
IBM DB2®, Oracle, SQL Server, and SAP HANA databases (DBs), and SAP workloads SD,
BW, TRBK, FI, ATO, and others running on IBM AIX®, Linux, and Windows servers. Damon
holds a Bachelor of Science in Computer and Information Sciences from the University of
Oregon.
Vinicius Cosmo Cardoso is an IBM Certified Expert IT Specialist and Senior SAP Basis
Administrator working for IBM Brazil. He has 12 years of experience in SAP, working on
complex projects like new implementations, upgrades, and platform migrations. He is an SAP
certified professional for SAP NetWeaver, SAP OS/DB Migration, and SAP HANA. Vinicius
holds a Master of IT Solutions Architecture from 2018 and a Bachelor of Computer Science
from 2008. Throughout these 12 years, he has worked for several Brazilian and global clients
in several industry areas.
Eric Kass is an IBM Developer Architect in Worldwide SAP Technical Enablement, which is
part of an IBM Systems group that is based in Boeblingen, Germany. Eric started with IBM in
1997 in operating system (OS) network and communication development, where he wrote
device control and network routing code. In 2000, he spent a year with SAP to write the DB
layer so that SAP can communicate between Windows and IBM i. He became a successful
IBM Developer and architect working at the SAP development lab, where he designs and
codes DB drivers; SAP kernel components; and SAP and database high availability (HA)
engines, network drivers, and security protocols. Eric has over 20 patents in SAP related
fields, and he supports worldwide SAP customers on IBM i and AS400 platforms.
Wade Wallace
IBM Redbooks, Austin Center
Find out more about the residency program, browse the residency index, and apply online at:
ibm.com/redbooks/residencies.html
Comments welcome
Your comments are important to us!
We want our papers to be as helpful as possible. Send us your comments about this paper or
other IBM Redbooks publications in one of the following ways:
Use the online Contact us review Redbooks form found at:
ibm.com/redbooks
Send your comments in an email to:
redbooks@us.ibm.com
Preface ix
x SAP HANA Platform Migration
1
This chapter provides a list of possible migrations scenarios for SAP HANA DBs on
IBM Power Systems, and it describes the different SAP migration tools to accomplish each
scenario.
The purpose of this publication is to provide an overview of the SAP tools and methods you
can use to migrate your source SAP environment to SAP HANA on IBM Power Systems,
including its prerequisites. For more information about the technical step-by-step procedure
and preparations, see the SAP official documentation at the SAP HANA Help Portal.
In this matter, SAP has two concepts for SAP systems migration: Homogeneous system copy
and heterogeneous system copy.
Here are the methods for performing an SAP homogeneous system copy:
DB export and import by using SAP migration tools
DB backup and recovery by using backup tools that are supported for the DB
Hardware migration and clones by using supported tools for the hardware
Virtual machine (VM) copy
The method for performing an SAP heterogeneous system copy is to first export the DB and
then import it by using SAP migration tools.
1.2 Tools and methods that are provided by SAP for database
migration to an SAP HANA DB on Power Systems
To migrate SAP applications (for example, based on SAP NetWeaver) to SAP HANA or
migrate SAP HANA as a source DB to SAP HANA as a target DB, use appropriate method
and tools.
SAP Software Provisioning Manager (SWPM) is a tool that performs software provisioning
processes such as system installation, system copy and migration, system rename, and
dual-stack1 split (SAP Business Suite system and SAP NetWeaver system). SWPM is
delivered with the SAP Software Logistics Toolset. SWPM calls the R3load process at the OS
level for migration of the SAP Advanced Business Application Programming (ABAP) stack DB
objects, and the Jload process for migration of the SAP JAVA stack DB objects.
Table 1-1 on page 5 shows possible migration methods and tools for various common
scenarios.
Note: Table 1-1 on page 5 addresses only migration to SAP HANA DB on Power Systems
as a target OS.
1
SAP Software Provisioning Manager: Dual-stack split case, found at:
https://support.sap.com/en/tools/software-logistics-tools/software-provisioning-manager.html
SAP HANA 1.0 Big SAP HANA 1.0 Big Yes SWPM (R3load
Endian Endian and Jload)
SAP HANA
System
Replication (HSR)
Backup and
recovery
SAP HANA 1.0 Little SAP HANA 1.0 Big Yes SWPM (R3load
Endian Endian and Jload)
SAP HANA 1.0 Big SAP HANA 2.0 Yes SWPM (R3load
Endian and Jload)
SAP HANA
migration tool
Combined SWPM
and SAP HANA
migration tool
SAP HANA 1.0 Little SAP HANA 2.0 Yes SWPM (R3load
Endian and Jload)
Backup and
recovery
HSR
The SAP HANA Migration Tool is a toolkit that comes with the SAP HANA 2.0 installation
package for Power Systems. It performs the migration and conversion of all DB objects from
SAP HANA 1.0 Big Endian for Power Systems to SAP HANA 2.0 Little Endian for Power
Systems. Chapter 3, “Migrating SAP HANA to SAP HANA on IBM Power Systems” on
page 17 describes the procedure for using this tool.
DMO is a tool that is integrated into the SAP Software Update Manager (SUM) tool. The SUM
tool is delivered with the SAP Software Logistics Toolset.
HSR is an SAP HANA Platform feature for replicating one source SAP HANA DB to a target
SAP HANA DB. It is primarily used for disaster recovery (DR) and high availability (HA)
purposes, but it also can be used to migrate the SAP HANA DB.
Warning:
For backup and recovery and HSR methods, see SAP Note 1948334. The same path
for SAP HANA updates must be followed for backup and recovery and System
Replication.
For more information about backup and recovery and homogeneous system copy, see
SAP Note 1642148 SAP Note 1642148 and SPA Note 1844468.
Before installing SAP HANA 1.0 or 2.0 on Power Systems, see SAP Note 2188482.
For more information about an overall compatibility check, see the SAP Product
Availability Matrix (PAM).
Note: This section describes migration from other DB types to SAP HANA. This migration
does not apply to SAP/4SAP HANA and BW/4SAP HANA products because they run in
SAP HANA only.
Since SAP Software Logistics Toolset 1.0 SPS 23, there are two versions of SWPM available:
Version 1.0 and Version 2.0.
Version 1.0 supports provisioning of SAP systems of any supported DB type other than SAP
HANA. Version 2.0 supports provisioning of SAP systems on SAP HANA only.
For version 1.0, there are two options: one for SAP systems that are based on NetWeaver
7.0X, and one for SAP systems that are based on NetWeaver higher than 7.0X (for example,
7.4 and 7.5).
Figure 2-1 shows SWPM 1.0 for SAP NetWeaver-based systems higher than 7.0X. All SAP
products are available in one tool that contains the capabilities of SAP Software Logistics
Toolset.
Chapter 2. Migrating SAP systems from a non-SAP HANA DB to an SAP HANA on IBM Power Systems DB 9
Software Provisioning Manager window for export and import
Figure 2-3 shows the SWPM window for migrating by using the System Copy option. The
options for exporting from a source and importing in to a target are available.
Figure 2-3 System Copy options in Software Provisioning Manager initial window
R3load exports and imports SAP NetWeaver Advanced Business Application Programming
(ABAP) based products, and Jload exports and imports SAP NetWeaver Java based
products.
Table 2-1 on page 11 shows the capabilities of the R3load and Jload processes.
In this case, there are options that are available to speed up the export and import processes.
To transfer the export files from the source to the target environment, the tool provides two
options:
Transfer the files by using the integrated FTP utility.
Transfer Network File System (NFS) shares from the source environment to the target
environment.
Choose one of these two options based on the latency of your network.
Chapter 2. Migrating SAP systems from a non-SAP HANA DB to an SAP HANA on IBM Power Systems DB 11
The parallel export and import feature is integrated into the SWPM. In the SAP System
Database Export window for setting up export parameters, there is the Perform Parallel
Export and Import check box, as shown in Figure 2-4.
Figure 2-4 Perform Parallel Export and Import check box in Software Provisioning Manager
Figure 2-5 shows the Data Transfer options that you can choose: NFS or FTP.
Figure 2-5 SAP System Data Transfer Parameters for Export in Software Provisioning Manager
Table splitting
Another advanced and useful technique to speed up the migration process is table splitting.
When using the standard configuration for the export process, all tables are exported by one
R3load process each. Depending on the size of the tables, the export process can take a long
time.
By using the table splitting technique, large tables of the source DB can be exported as a
number of predefined segments. The table is exported in parallel by several R3load
processes, one for each table segment.
A text file must be created that defines the splitting criteria of each table to be exported in
parallel. Each table is alphabetically defined by name, followed by a % and the number of
segments to split the table into. For example, CDCLS%30 splits the table CDCLS into
30 segments.
Then, SWPM splits the defined tables by using the R3ta process from the SAP system kernel.
The R3ta process creates text control files for each table that define the split criteria, which
are based on the primary key data from the table, and they are automatically chosen by the
R3ta processes. Then, this information is used by the R3load process to split the export of the
table into parallel processes.
After the export process starts, one R3load process starts for each split of the table, which
speeds up the table export.
Chapter 2. Migrating SAP systems from a non-SAP HANA DB to an SAP HANA on IBM Power Systems DB 13
In the SWPM SAP System Split STR Files window (when splitting tables, this window is used
before the export process), select and define the parameters for the splitting tool, as shown in
Figure 2-7.
Database tuning
Before you start the export process, adjust your source DB to optimize the export. At the SAP
Support Portal, you can search for SAP Notes about tuning the source DB. For example, if the
source DB is Oracle, you can use SAP Note 936441 to apply important recommendations
before starting the export.
Note: For more information about all the prerequisites, necessary preparation activities,
and details about migration advanced techniques, see the SAP System Copy Guide for
your SAP system version. For more information about the SWPM tool, see the SAP
Installation Guide for your SAP system version. You can find this documentation by going
to the Guide Finder for SAP Netweaver and ABAP Platorm.
Figure 2-8 DMO option window in the Software Update Manager tool
Because DMO is a component of the SUM tool, it is also part of the Software Logistics
Toolset, so it is updated on a regular basis regardless of SAP products releases.
With DMO, you cannot migrate your SAP system to SAP HANA or perform a combined SAP
upgrade or Support Package update and migration to SAP HANA in one step. Because DMO
is integrated into the SUM tool, it uses all the SUM tool capabilities for the upgrade or update.
Chapter 2. Migrating SAP systems from a non-SAP HANA DB to an SAP HANA on IBM Power Systems DB 15
Another advantage of the DMO option is that the source system is not altered during the
upgrade or update and migration process. All upgrade and update processing is performed in
the target system, which means that there is an instant reactivation of the source system if
there are any problems or failures during the DMO process. Figure 2-9 shows an overview of
the DMO update and upgrade migration process.
DMO performs table splitting and most of the preparation steps automatically (for example, it
generates the DDL statements by using report SMIGR_CREATE_DDL).
When DMO was released, migrating only the DB to SAP HANA was supported. The
application environment had to be migrated manually.
Starting with SUM 1.0 SP20, SAP introduced a new feature for DMO called DMO with System
Move. With this new feature, you can migrate your entire SAP system by using DMO, that is,
the DB and the SAP application servers.
Caution: DMO is not supported for migration from SAP HANA DB to SAP HANA DB.
For more information about how to work with DMO for migration to SAP HANA DB and all the
necessary preparation activities, see Database Migration Option: Target Database SAP
HANA, which can be found at the SAP Help Portal. Also, see the DMO release SAP Note for
the version of the SUM tool that you are using. For example, for DMO with SUM 2.0 SP07,
see SAP Note 2840346.
Note: Endianness means the order in which a sequence of bytes is stored in the computer
memory. For more information, see SAP Note 552464.
Note: SAP HANA 1.0 on Power Systems is Big Endian only. SAP HANA 2.0 on Power
Systems is Little Endian only.
The complete procedure for backup and recovery for SAP systems running on SAP HANA is
described in SAP Note 1844468.
1
Endianness described at https://techterms.com/definition/endianness.
When you configure HSR, it first performs an initial synchronization of the entire DB from the
primary SAP HANA environment (source) to the secondary SAP HANA environment (target).
Then, continuous replication ensures synchronization until a takeover is made in the
secondary environment, as shown in Figure 3-1.
To enable and register the SAP HANA environments, you can use SAP HANA Studio, SAP
HANA Cockpit, and the SAP HANA command line.
In the command line, you can enable HSR in the primary SAP HANA system by completing
the following steps:
1. Run the hdbnsutil command as the <sid>adm user, and using the syntax shown in
Example 3-1.
Example 3-1 SAP HANA System Replication: Enabling the primary by running the hdbnsutil
command
hdbnsutil -sr_enable --name=<siteName>
The string <siteName> = Alias represents your primary system. Assign it as the primary
system for system replication.
2. To check whether the system was successfully enabled for system replication, run the
command that is shown in Example 3-2.
Example 3-2 SAP HANA System Replication: Checking whether the primary is activated
hdbnsutil -sr_state
Example 3-3 SAP HANA System Replication: Registering secondary system with the hdbnsutil
command
hdbnsutil -sr_register --name=<secondarySiteName> --remoteHost=<primary_host>
--remoteInstance=<primary_systemnr>
--replicationMode=[sync|syncmem|async]--operationMode=[delta_datashipping|logre
play|logreplay_readaccess]
Where:
--name Alias that is used to represent the secondary system.
--remoteHost Name of the primary host that the secondary registers with.
--remoteInstance Instance number of the primary.
--replicationMode Log replication modes.
--operationMode Log operation mode.
--online If the system is running, you can use this parameter to
automatically perform a system restart. Not relevant if the
system is shut down.
--force_full_replica Use this parameter to initiate a full data shipping. Otherwise, a
delta data shipping is attempted.
4. After this command runs on the secondary system, SAP HANA starts the system
replication process and synchronizes data from the source system. To check whether the
system successfully registered for system replication, run the command that is shown in
Example 3-4.
Example 3-4 SAP HANA System Replication: Checking whether the secondary system registered
hdbnsutil -sr_state
5. To see the initial full replica window that is shown in Figure 3-2, select SAP HANA
Studio → Landscape → System Replication.
Figure 3-2 SAP HANA System Replication: Initial full replica running
Figure 3-2 shows that the replication started for the indexserver service, which has the
DB.
6. When possible, complete the migration process by completing the following steps:
a. Stop the source SAP system (not the SAP HANA DB).
b. Perform a takeover on the SAP HANA secondary system.
c. Start the target SAP system.
d. Stop the source SAP HANA DB.
7. To perform the takeover on the SAP HANA secondary system, run the command that is
shown in Example 3-5.
Example 3-5 SAP HANA System Replication: Takeover by using the hdbnsutil command
hdbnsutil -sr_takeover
For more information about the HSR prerequisites and procedures, see the following
documentation:
SAP Note 1999880
SAP HANA System Replication Guide, found at the SAP Support Portal
3.1.4 Using SAP Software Provisioning Manager with the SAP HANA Migration
Tool
If you are migrating from SAP HANA 1.0 on Power Systems to SAP HANA 2.0 on Power
Systems, you can use the SAP HANA Migration Tool.
SAP HANA Migration Tool was developed to migrate from the Big Endian mode that is used in
SAP HANA 1.0 for Power Systems to the Little Endian mode that is used in SAP HANA 2.0 for
Power Systems.
SAP HANA 1.0 for Power Systems was developed for Big Endian mode only, and SAP HANA
2.0 for Power Systems was developed for Little Endian only, so it is not possible to use the
backup and restore or HSR methods.
You can use the SAP HANA Migration Tool to migrate the entire source Big Endian DB to the
target Little Endian system. But the SAP HANA Migration Tool is not as fast or efficient as the
SWPM. Therefore, using the SAP HANA Migration Tool by itself can take considerable time if
you migrate a large-sized DB.
The migration process that uses the SAP HANA Migration Tool combined with SWPM is
shown in Figure 3-4.
For more information about this procedure, see the following documentation:
SAP HANA Big Endian to Little Endian Migration
SAP Note 2802500
SAP Note 2537080
Note: SAP HANA DB Big Endian was released only on Version 1.0 for Power Systems.
For other scenarios (SAP HANA Database 2.0 on Power Systems or SAP HANA 1.0 on X86
platform as the source DB), both source and target are in Little Endian mode.
Therefore, for this singular case, use the SAP HANA Migration Tool and see the following
documentation:
SAP HANA Big Endian to Little Endian Migration
SAP Note 2537080
The publications that are listed in this section are considered suitable for a more detailed
description of the topics that are covered in this paper.
IBM Redbooks
The following IBM Redbooks publications provide more information about the topic in this
document. Some publications that are referenced in this list might be available in softcopy
only.
IBM Power Systems Security for SAP Applications, REDP-5578
IBM Power Systems Virtualization Operation Management for SAP Applications,
REDP-5579
SAP HANA on IBM Power Systems: High Availability and Disaster Recovery
Implementation Updates, SG24-8432
SAP Landscape Management 3.0 and IBM Power Systems Servers, REDP-5568
You can search for, view, download, or order these documents and other Redbooks,
Redpapers, web docs, drafts, and additional materials, at the following website:
ibm.com/redbooks
Online resources
These websites are also relevant as further information sources:
Guide Finder for SAP NetWeaver and Advanced Business Application Programming
(ABAP) Platform
https://help.sap.com/viewer/nwguidefinder
SAP Support Portal
https://support.sap.com/en/index.html
Software Logistics Tools
https://support.sap.com/en/tools/software-logistics-tools.html
Welcome to the SAP Help Portal
https://help.sap.com
REDP-5571-00
ISBN 0738458651
Printed in U.S.A.
®
ibm.com/redbooks