3. 1 Document History
Note
Before you start the implementation, make sure you have the latest version of this document.
Version Date Description
1.00 2020-01-17 Initial version
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
Document History P U B L I C 3
4. 2 Customized Installation of SQL Server
2019 for an SAP System with SQL4SAP
2.1 Introduction
This document explains how to use the SQL4SAP script to install SQL Server 2019 for your SAP system. For
up-to-date information on the installation of SQL Server 2019 with SQL4SAP, see SAP Note 2729848 .
Caution
The SQL4SAP script does not support high availability on Windows with failover clustering. For more
information about how to install your SQL Server database software for a high-availability system, see the
installation guide for MS SQL Server.
Features
● With SQL Server 2016, Microsoft changed the default for the Customer Experience Improvement Program
(CEIP). The CEIP is now enabled by default.
SQL4SAP will disable CEIP for the SQL Server instance after the installation.
For more information about how to disable CEIP manually, read the Microsoft KB 3153756, which is
available at (https:/
/support.microsoft.com/en-us/kb/3153756 ).
● With the SQL4SAP script you can install:
○ The 64-bit SQL Server 2019 Enterprise Core Edition on x64 systems
Caution
SAP does not support SQL Server 2019 on all SAP products. For more information, see the Product
Availability Matrix (PAM) at:
https:/
/support.sap.com/pam .
○ The latest SQL Server 2019 service pack, or cumulative update (if available)
Caution
You cannot use the SQL4SAP script to upgrade SQL Server 2005, SQL Server 2008 (R2), SQL
Server 2012, SQL Server 2014, SQL Server 2016 or SQL Server 2017 to SQL Server 2019.
○ Default Instances, Named Instances, or SQL Server Client Tools only, or Microsoft ODBC Driver for SQL
Server
● During the installation, an output console window appears that shows all installation steps at all times.
4 P U B L I C
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
5. ● If you have UAC enabled on your operating system, the following User Account Control window might
appear:
User Account Control Window
Required SQL Server 2019 Installation Medium
Before SQL Server 2016, SAP has always prepared and provided a single SQL Server RDBMS medium to all
customers regardless of whether they bought the SQL Server license from SAP or from another vendor. As of
SQL Server 2016, there are two SQL Server RDBMS media available for SAP customers. Besides these two
media delivered by SAP, an SQL Server installation medium is also available. This is officially delivered by
Microsoft or authorized dealers..
Available Media
Media Description
SQL Server RDBMS medium (for run
time customers)
Contains both the SQL4SAP framework and the SQL Server installation medium
(see below) to install the SQL Server database. The structure of this medium is
identical to SAP medium delivered for previous SQL Server releases. The medium
can be used by customers who purchase their SQL Server license from SAP.
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP P U B L I C 5
6. Media Description
SQL Server RDBMS medium (for non-
runtime customers)
Contains the SQL4SAP framework but not the SQL Server installation medium
(see below). During the installation with SQL4SAP, you are prompted to provide
the location of the SQL Server installation medium. The medium can be used by
customers who do not purchase their SQL Server license from SAP.
SQL Server installation medium SQL Server installation medium that is officially delivered by Microsoft or author
ized dealers for the installation of the Microsoft SQL Server 2019 database.
Prerequisites
You use one of the following 64-bit Windows operating systems:
● Windows Server 2016 Editions:
○ Windows Server 2016 Standard Edition
○ Windows Server 2016 Datacenter Edition
● Windows Server 2019 Editions:
○ Windows Server 2019 Standard Edition
○ Windows Server 2019 Datacenter Edition
For more information about the prerequisites for SQL Server 2019, see:
Hardware and software requirements for installing SQL Server
2.2 Installing SQL Server 2019
Use
This procedure describes how to install SQL Server 2019 or higher with the SQL4SAP. The script also installs
required additional software – for example, the .NET Framework 3.5 SP1 patch, or PowerShell 2.0.
Procedure
1. Run the SQL4SAP.BAT script from an elevated command prompt.
The script is located in the root directory of your SQL Server 2019 RDBMS medium (for runtime customers
or for non-runtime customers) provided by SAP.
2. If you started the script from a network share, a security dialog might appear.
To continue, choose Run.
6 P U B L I C
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
7. 3. If you use the SQL Server RDBMS medium (for non-runtime customers) which does not contain the SQL
Server binaries, you are prompted to enter the path to the directory that contains the SQL Server
setup.exe file
4. Choose your installation type.
1. To install SQL Server 2019 (default), press Enter.
2. To install the SQL Server Client Tools software for monitoring your SAP system, type 2 and then press
Enter.
3. To install the Microsoft ODBC Driver for SQL Server software for monitoring your SAP system, type 3
and then press Enter.
Note
If you install an SAP application server, you can also install the Microsoft ODBC Driver for SQL
Server instead of the SQL Server Client Tools. You find the ODBC files on the SQL Server 2019
RDBMS medium in the directory: <RDBMS_Media>:SqlNativeClient
For more information, see SAP Note 2729848 .
5. If you have chosen the first option SQL Server installation, SQL4SAP asks you to enter the name of the SQL
Server instance.
To install a default instance (recommended), press Enter.
6. By default, SQL4SAP adds the BUILTINAdministrators group to the SQL Server logins.
If you wish to add a different user, enter the name and press Enter.
7. Wait until SQL4SAP finished the installation of SQL Server 2019.
Caution
Do not close the output console window, which shows all installation steps at all times.
8. When the installation is finished, restart your system.
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP P U B L I C 7
8. 9.
Installation Finished Successfully
10. After the SQL4SAP window has closed, check the SQL4SAP.log file, which is located in the WINDOWS
directory. The log file contains all installation steps, return codes, and SQL commands.
8 P U B L I C
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
9. 3 Additional Information
3.1 Introduction
The SQL4SAP.bat script installs Microsoft SQL Server in Windows Authentication mode. The script disables the
sa login and sets a random password for the sa login. If you want to use the sa login, you must change the
authentication mode into SQL Server and Windows Authentication mode, enable the sa login and set its
password, as described below.
3.2 Changing the Windows Authentication Mode into SQL
Server and Windows Authentication Mode
To use SQL Server and Windows Authentication mode, you have the following options:
● You use the script _SqlAuth.bat, which is located in the root directory on the RDBMS DVD, to
automatically install SQL Server 2019 with authentication mode SQL Server and Windows Authentication.
Note
A Java system requires the SQL Server and Windows Authentication mode.
● You manually change the authentication mode Windows Authentication to SQL Server and Windows
Authentication in the SQL Server Management Studio as follows:
1. On your Start screen, choose SQL Server Management Studio.
2. In the Connect to Server window, enter the server name (if required), and choose Connect.
3. Right-click the SQL Server instance and choose Properties.
4. Choose Security.
5. For Server authentication, choose SQL Server and Windows Authentication mode.
6. Choose OK.
7. Restart SQL Server.
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
Additional Information P U B L I C 9
10. Changing the Authentication Mode
3.3 Setting and Enabling the Password for the SQL Server
Login sa
To set and enable the password for the sa login, you use the SQL Server Management Studio:
1. On your Start screen, choose SQL Server Management Studio.
2. In the Connect to Server window, enter the server name (if required), and choose Connect.
3. Choose the SQL Server instance Security Logins .
10 P U B L I C
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
Additional Information
11. 4.
Selecting the SQL Server Login sa
5. Right-click sa and choose Properties.
6. Under General, enter and confirm the password for the sa login.
7. Under Status, choose Login Enabled.
8. Choose OK.
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
Additional Information P U B L I C 11
12. Setting the Password for the SQL Server Login sa old
12 P U B L I C
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
Additional Information
13. Enabling the Password for the SQL Server Login sa
3.4 Updating the SQL4SAP Medium
Use
You can update the SQL4SAP medium to include SQL Server patches such as Service Packs, Cumulative
Updates (CU) etc. in the installation. Only new installations use the patches. If you want to patch an existing
installation, you have to patch the SQL Server instance manually.
Procedure
To update the SQL4SAP medium, proceed as follows:
1. Copy the SQL4SAP medium to a local directory.
2. Download the patches that you want to include to a local directory.
3. Copy the patches to <SQL4SAP medium>x64Patches<Architecture>.
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
Additional Information P U B L I C 13
14. Example
To include Cumulative Update 1 for SQL Server 2019, proceed as follows:
1. Copy the SQL4SAP medium to c:tempsql4sap.
2. Download the CU1 file from the Microsoft Download Center.
3. Copy the 64-bit CU1 file to c:tempsql4sapx64Patches.
4. Install SQL Server 2019 as described in Installing SQL Server 2019 [page 6].
Note
The SQL4SAP command window still shows the old SQL Server version. However, the new SQL Server
version is installed.
5. You can check the installed SQL Server version by executing the following commands:
○ If you have installed a default instance, enter:
sqlcmd.exe -Q "select @@version"
○ If you have installed a named instance, enter:
sqlcmd.exe -S .<instance name>-Q "select @@version"
14 P U B L I C
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
Additional Information
15. Important Disclaimers and Legal Information
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:
● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such
links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.
Beta and Other Experimental Features
Experimental features are not part of the officially delivered scope that SAP guarantees for future releases. This means that experimental features may be changed by
SAP at any time for any reason without notice. Experimental features are not for productive use. You may not demonstrate, test, examine, evaluate or otherwise use
the experimental features in a live operating environment or with data that has not been sufficiently backed up.
The purpose of experimental features is to get feedback early on, allowing customers and partners to influence the future product accordingly. By providing your
feedback (e.g. in the SAP Community), you accept that intellectual property rights of the contributions or derivative works shall remain the exclusive property of SAP.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Gender-Related Language
We try not to use gender-specific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.
Videos Hosted on External Platforms
Some videos may point to third-party video hosting platforms. SAP cannot guarantee the future availability of videos stored on these platforms. Furthermore, any
advertisements or other content hosted on these platforms (for example, suggested videos or by navigating to other videos hosted on the same site), are not within
the control or responsibility of SAP.
Customized Installation of SQL Server 2019 for an SAP System with SQL4SAP
Important Disclaimers and Legal Information P U B L I C 15