Operations Guide | PUBLIC Software Provisioning Manager 2.0 SP09 Document Version: 1.9.0 – 2021-06-21

System Rename for SAP ABAP Systems Based on UNIX : SAP HANA 2.0 Database - Using Software Provisioning Manager 2.0 This Guide is Valid for SAP Systems based on the Following SAP Product Versions: - SAP S/4HANA 2020 company. All rights reserved. - SAP S/4HANA 1909 affiliate - SAP S/4HANA 1809 - SAP BW/4HANA 2.0 - SAP BW/4HANA 1.0 Support Release 1 THE BEST RUN 2021 SAP SE or an SAP © Content

1 About this Document - System Rename for SAP Systems Based on UNIX : SAP HANA 2.0 Database - Using Software Provisioning Manager 2.0...... 5 1.1 About Software Provisioning Manager 2.0...... 6 SAP Products Supported by Software Provisioning Manager 2.0...... 7 1.2 Use Cases of System Rename...... 8 1.3 How to Use this Guide...... 9 1.4 Naming Conventions...... 9 1.5 New Features...... 10 1.6 Constraints...... 12 1.7 Accessing the Installation Guides and System Copy Guides...... 13 1.8 Accessing the SAP Online Documentation...... 13

2 Planning...... 14

3 Preparation...... 15 3.1 Preparation Checklist...... 15 3.2 General Technical Preparations ...... 15 3.3 Creating Operating System Users and Groups...... 16 3.4 Performing a System Copy by Copying the File System...... 21 3.5 Deleting Additional Application Server Instances...... 22 3.6 Performing SAP HANA Database-Specific Preparation Steps...... 23 3.7 Downloading and Extracting the Software Provisioning Manager 2.0 Archive...... 24 3.8 Preparing the File System...... 25

4 System Rename Procedure...... 27 4.1 System Rename Procedure Checklist...... 27 4.2 Prerequisites for Running the Installer...... 28 4.3 Running the Installer...... 31 4.4 Additional Information about the Installer...... 35 Useful Information about the Installer...... 36 System Provisioning Using a Parameter Input File...... 38 Interrupted Processing of the Installer...... 42 Troubleshooting with the Installer...... 45 Using the Step State Editor (SAP Support Experts Only)...... 46

5 Follow-Up Activities...... 48 5.1 Follow-Up Activities Checklist...... 48 5.2 General Follow-Up Activities...... 49

System Rename for SAP ABAP Systems Based on UNIX : SAP HANA 2.0 Database - Using Software Provisioning Manager 2.0 2 PUBLIC Content 5.3 Performing Follow-Up Activities in the Source System...... 50 5.4 Performing Follow-Up Activities in the Target System...... 50 Performing Follow-Up Activities for ABAP...... 50 Performing Product-Specific Follow-Up Activities...... 56 5.5 Configuring the Transport Management System...... 57 5.6 Performing Follow-Up Activities for SAP HANA Database...... 57 5.7 Starting the SAP System...... 58 5.8 Changing the IGS Destination...... 58

System Rename for SAP ABAP Systems Based on UNIX : SAP HANA 2.0 Database - Using Software Provisioning Manager 2.0 Content PUBLIC 3 Document History

 Note

Before you start reading, make sure you have the latest version of this system rename guide, which is available at: https://help.sap.com/viewer/swpm20guides

The following table provides an overview on the most important document changes:

Version Date Description

1.9.0 2021-06-21 Updated version for Software Provisioning Manager 2.0 SP09 (SL Toolset 1.0 SP32)

1.8.0 2021-02-15 Updated version for Software Provisioning Manager 2.0 SP08 (SL Toolset 1.0 SP31)

1.7.0 2020-10-05 Updated version for Software Provisioning Manager 2.0 SP07 (SL Toolset 1.0 SP30)

1.6.0 2020-06-08 Updated version for Software Provisioning Manager 2.0 SP06 (SL Toolset 1.0 SP29)

1.5.0 2020-01-20 Updated version for Software Provisioning Manager 2.0 SP05 (SL Toolset 1.0 SP28)

1.4.0 2019-09-16 Updated version for Software Provisioning Manager 2.0 SP04 (SL Toolset 1.0 SP27)

1.3.0 2019-05-27 Updated version for Software Provisioning Manager 2.0 SP03 (SL Toolset 1.0 SP26)

1.2.0 2019-01-21 Updated version for Software Provisioning Manager 2.0 SP02 (SL Toolset 1.0 SP25)

1.1.0 2018-09-17 Updated version for Software Provisioning Manager 2.0 SP01 (SL Toolset 1.0 SP24)

1.0.0 2018-04-23 Initial version for Software Provisioning Manager 2.0 SP00 (SL Toolset 1.0 SP23)

System Rename for SAP ABAP Systems Based on UNIX : SAP HANA 2.0 Database - Using Software Provisioning Manager 2.0 4 PUBLIC Document History 1 About this Document - System Rename for SAP Systems Based on UNIX : SAP HANA 2.0 Database - Using Software Provisioning Manager 2.0

This documentation describes how to rename SAP Appliaction Server ABAP systems using Provisioning Manager 2.0 SP09 (the “installer” for short) on UNIX .

It covers the following SAP ABAP system product releases (see also SAP Products Supported by Software Provisioning Manager 2.0 [page 7]):

● SAP S/4HANA Server 2020 (based on SAP S/4HANA Foundation 2020) ● SAP S/4HANA Server 1909 (based on SAP S/4HANA Foundation 1909) ● SAP S/4HANA Server 1809 (based on foundation on ABAP Platform 1809, version for SAP HANA) ● SAP BW/4HANA 2.0 (based on SAP BW/4HANA Server 2.0) ● SAP BW/4HANA 1.0 Support Release 1 (based on SAP BW/4HANA Server 1.0 Support Release 1)

For information about supported operating system and database platforms, see the Product Availability Matrix at https://support.sap.com/pam .

Software Provisioning Manager 2.0 SP09 [page 6] is part of Software Logistics Toolset 1.0 SP32.  Note

As an alternative to using Software Provisioning Manager, you can rename your system with a completely automated end-to-end framework available using SAP Landscape Management. For more information, see SAP Note 1709155 and https://help.sap.com/lama .

 Caution

You should only perform a system rename using the Software Provisioning Manager 2.0 if your SAP system is installed with standard SAP tools according to the documentation available at https://support.sap.com/ sltoolset System Provisioning .

Any deviations from this documentation are at your own risk. Be aware that additional consulting effort might be necessary.

About Software Provisioning Manager 2.0 [page 6]

Use Cases of System Rename [page 8]

How to Use this Guide [page 9]

Naming Conventions [page 9]

New Features [page 10]

Constraints [page 12]

Accessing the Installation Guides and System Copy Guides [page 13]

Accessing the SAP Online Documentation [page 13]

System Rename for SAP ABAP Systems Based on UNIX : SAP HANA 2.0 Database - Using Software Provisioning Manager 2.0 About this Document - System Rename for SAP Systems Based on UNIX : SAP HANA 2.0 Database - Using Software Provisioning Manager 2.0 PUBLIC 5 1.1 About Software Provisioning Manager 2.0

Software Provisioning Manager 2.0 is the new release of Software Provisioning Manager 1.0. Software Provisioning Manager as such is the successor of the product- and release-specific delivery of provisioning tools, such as SAPinst and R3setup.

Make sure that you read the most recent version of SAP Note 2568783 (Release Note for Software Provisioning Manager 2.0).

Before you run Software Provisioning Manager 2.0, we recommend that you always download the latest version of it. Software Provisioning Manager 2.0 is - as Software Provisioning Manager 1.0 - part of the Software Logistics Toolset 1.0 (“SL Toolset” for short) which is quarterly shipped. This way, you automatically get the latest fixes and supported processes. For more information about Software Provisioning Manager 2.0 as well as products and releases supported by it, see SAP Note 2568783 and http://scn.sap.com/docs/DOC-30236 .

Software Provisioning Manager 2.0 Versus Software Provisioning Manager 1.0

The Software Provisioning Manager 2.0 SP09 exists in parallel to Software Provisioning Manager 1.0 SP32. Both Software Provisioning Manager versions are part of Software Logistics Toolset 1.0 SP 32. However, they cover system provisioning for different product versions. The decision matrix is as follows:

● Software Provisioning Manager 2.0 is used for: ○ Installation, system copy, and system rename of ABAP single stack systems on SAP HANA 2.0 database, based on the following products: ○ SAP S/4HANA Server 2020 ○ SAP S/4HANA Server 1909 ○ SAP S/4HANA Server 1809 ○ SAP BW/4HANA 2.0 ○ SAP BW/4HANA 1.0 Support Release 1 ○ SAP Web Dispatcher installation and rename.

 Note

For SAP Web Dispatcher, you can either use Software Provisioning Manager 2.0 or Software Provisioning Manager 1.0.

○ SAP Host Agent standalone installation.

 Note

For SAP Host Agent standalone installation, you can either use Software Provisioning Manager 2.0 or Software Provisioning Manager 1.0.

● Software Provisioning Manager 1.0 is used for: ○ Installation, system copy, system rename of SAP Solution Manager 7.X and Diagnostics Agent. ○ Installation of standalone engines and clients.

System Rename for SAP ABAP Systems Based on UNIX : SAP HANA 2.0 Database - Using Software Provisioning Manager 2.0 About this Document - System Rename for SAP Systems Based on UNIX : SAP HANA 6 PUBLIC 2.0 Database - Using Software Provisioning Manager 2.0  Note

For SAP Web Dispatcher or SAP Host Agent standalone installation, you can either use Software Provisioning Manager 1.0 or Software Provisioning Manager 2.0.

○ Installation, system copy, system rename, and dual-stack split of SAP systems whose database is not SAP HANA. ○ Installation, system copy, and system rename of Dual-stack and Java single stack systems. ○ Installation, system copy, and system rename of ABAP single stack systems whose database is SAP HANA database, but whose release is one of the following: ○ SAP BW/4HANA 1.0 or lower ○ SAP S/4HANA 1709 or lower ○ SAP NetWeaver AS for ABAP 7.52 or lower

For more information, see https://blogs.sap.com/2018/05/15/software-provisioning-manager-1.0-vs.- software-provisioning-manager-2.0/ .

Naming Conventions

“SAPinst” has been renamed to “Software Provisioning Manager” (“installer” for short), but the terms “SAPinst” and “sapinst” are still used in:

● The name of the technical framework of Software Provisioning Manager. For more information about the SAPinst Framework, see SAP Note 2393060 . ● Texts and screen elements in the Software Provisioning Manager GUI ● Names of executables, for example sapinst ● Names of command line parameters, for example SAPINST_HTTPS_PORT ● Names of operating system user groups, such as the additional group sapinst

In this documentation, we generally refer to Software Provisioning Manager as the “installer”. We only use the term “Software Provisioning Manager” if this is required for technical reasons, and “Software Provisioning Manager 2.0” if there is a significant difference compared to “Software Provisioning Manager 1.0”.

1.1.1 SAP Products Supported by Software Provisioning Manager 2.0

Here you can find the list of SAP products supported by Software Provisioning Manager 2.0.

SAP Product Based on

● SAP S/4HANA Server 2020 SAP S/4HANA Foundation 2020

● SAP S/4HANA Server 1909 SAP S/4HANA Foundation 1909

System Rename for SAP ABAP Systems Based on UNIX : SAP HANA 2.0 Database - Using Software Provisioning Manager 2.0 About this Document - System Rename for SAP Systems Based on UNIX : SAP HANA 2.0 Database - Using Software Provisioning Manager 2.0 PUBLIC 7 SAP Product Based on

● SAP S/4HANA Server 1809 foundation on ABAP Platform 1809, version for SAP HANA ● SAP ABAP Foundation 1809 on SAP HANA

SAP BW/4HANA 2.0 foundation on ABAP Platform 1809, version for SAP HANA FPS1

SAP BW/4HANA 1.0 Support Release 1 SAP NetWeaver 7.5

More Information

For more information about recommended application server platforms, see SAP Note 2620910 .

1.2 Use Cases of System Rename

This section describes which system parameters you can adapt using system rename.

You can adapt one or more of the following parameters of an SAP system using the system rename procedure:

● SAP system ID () ● Database ID () ● Instance numbers of the instances on the SAP system ● Host names

You can perform system rename in the following cases:

● You want to rename existing systems: ○ Systems installed by using the standard SAP tools. ○ Systems created by using SAP Landscape Management ○ Systems provided as virtual appliance ○ Cloned systems (virtual to virtual, virtual to physical, or physical to virtual) ● You performed a system copy by copying the file system [page 21] of a source SAP system and its database and want to rename the target system.

 Note

For production systems, the rename procedure should only be performed by experienced system administrators or consultants and should be tested beforehand – especially for the conversion of logic system names, the corresponding aspects outlined in SAP Note 121163 have to be considered.

System Rename for SAP ABAP Systems Based on UNIX : SAP HANA 2.0 Database - Using Software Provisioning Manager 2.0 About this Document - System Rename for SAP Systems Based on UNIX : SAP HANA 8 PUBLIC 2.0 Database - Using Software Provisioning Manager 2.0 More Information

For more information about offerings, methods, use cases and technical details of the system rename procedure, see http://scn.sap.com/docs/DOC-32851 .

1.3 How to Use this Guide

This documentation comprises the description of the system rename procedure and system rename-specific steps.

Context

For general installation or system copy-specific information, see the installation or system copy guides [page 13].

Procedure

1. You decide on the system parameters you want to change in the rename process. For more information, see Use Cases of System Rename [page 8]. 2. You follow the steps in each phase: ○ Planning [page 14] ○ Preparation [page 15] ○ Renaming [page 27] ○ Follow-Up Activities [page 48]

1.4 Naming Conventions

● “installer” refers to “Software Provisioning Manager 2.0” and to “Software Provisioning Manager” in general. ● “SAP system” or “ABAP system” refers to SAP systems based on: ○ SAP S/4HANA Server 2020 (based on SAP S/4HANA Foundation 2020)

 Note

For the sake of simplicity, in the following we abbreviate this product as ABAP Platform 2020.

System Rename for SAP ABAP Systems Based on UNIX : SAP HANA 2.0 Database - Using Software Provisioning Manager 2.0 About this Document - System Rename for SAP Systems Based on UNIX : SAP HANA 2.0 Database - Using Software Provisioning Manager 2.0 PUBLIC 9 ○ SAP S/4HANA Server 1909 (based on SAP S/4HANA Foundation 1909)

 Note

For the sake of simplicity, in the following we abbreviate this product as ABAP Platform 1909.

○ SAP S/4HANA Server 1809 (based on foundation on ABAP Platform 1809, version for SAP HANA)

 Note

For the sake of simplicity, in the following we abbreviate this product as ABAP Platform 1809.

○ SAP BW/4HANA 2.0 (based on SAP BW/4HANA Server 2.0) ○ SAP BW/4HANA 1.0 Support Release 1.

 Note

For the sake of simplicity, in the following we abbreviate this product as SAP BW/4HANA.

● Since - from a Software Provisioning Manager 2.0 perspective - the “Standalone Enqueue Server 2” is installed with the ASCS instance the same way as the classic “Standalone Enqueue Server”, both are addressed as “Standalone Enqueue Server” in this documentation. ● Since - from a Software Provisioning Manager 2.0 perspective - the “Enqueue Replicator 2” is installed with the ERS instance the same way as the classic “Enqueue Replication Server”, both are abbreviated as “ERS instance” in this documentation.

1.5 New Features

The sections below provide an overview of the new features in Software Provisioning Manager 2.0 (the“ installer” for short).

Make sure that you also read the Release Notes for your SAP product at https://help.sap.com