Installation of Diagnostics Agent on Windows

Installation Guide | PUBLIC Software Provisioning Manager 1.0 SP41 Document Version: 41.0 ? 2024-05-27

Installation of Diagnostics Agent on Windows

THE BEST RUN

? 2024 SAP SE or an SAP affiliate company. All rights reserved.

Content

1

Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.1 New Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

1.2 Service Pack Specific Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8

1.3 SAP Notes for the Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

1.4 Components for Reporting an Incident. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

1.5 Accessing the SAP Library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

2

Planning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.1 Planning Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.2 Installation Strategy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

2.3 Product Availability Matrix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.4 Hardware Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2.5 Kernel for the Diagnostics Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2.6 JVM for the Diagnostics Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

2.7 Connection Selection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

2.8 Direct SAP Solution Manager Connection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

2.9 Basic Installation Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

General Installation Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14

Diagnostics Agent System ID and Instance Number. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

Operating System Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

SAP Solution Manager Connectivity Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

3

Preparation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

3.1 Preparation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Required User Authorization for Running Software Provisioning Manager. . . . . . . . . . . . . . . . . . 21

3.2 SAP Directories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

3.3 Using Logical Host Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Using Virtual Host Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

3.4 Preparing the Installation Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Downloading and Extracting the Software Provisioning Manager 1.0 Archive. . . . . . . . . . . . . . . . 25

Media Required for the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Archive-Based Diagnostics Agent Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Downloading Complete Installation Media. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

3.5 Patching the Installation Media. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

3.6 Diagnostics Agent Download Paths. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32

4

Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

4.1 Installation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33

2

PUBLIC

Installation of Diagnostics Agent on Windows Content

4.2 Prerequisites for Running Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33 4.3 Running Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 4.4 Additional Information about Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Useful Information about Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 How to Avoid Automatic Logoff by Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . 41 Restarting Interrupted Processing of Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . 42 Troubleshooting with Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Using the Step State Editor (SAP Support Experts Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

5

Unattended Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

5.1 Unattended Installation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48

5.2 Unattended Archive-Based Diagnostics Agent Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

5.3 Preparing an Unattended Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

5.4 Running an Unattended Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

5.5 Running an Unattended Uninstallation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

5.6 Troubleshooting an Unattended Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57

6

Post-Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

6.1 Post-Installation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

6.2 Ensuring User Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

6.3 Complying with SAP Solution Manager Security Guidelines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

7

Additional Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

7.1 Installation Guidance for Experienced Administrators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

7.2 Installing the Diagnostics Agent Optionally with the SAP System. . . . . . . . . . . . . . . . . . . . . . . . . . . 62

7.3 Using the SMD Setup Script. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

7.4 Changing the Log Level. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

7.5 Starting and Stopping the SAP System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

7.6 Uninstalling an SAP System or Single Instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69

7.7 Backup and Recovery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

7.8 Software Provisioning Manager and Diagnostics Agent Version Information. . . . . . . . . . . . . . . . . . . 72

7.9 Unsupported Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

7.10 SAP Router. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

7.11 SAP System Security on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

7.12 Automatic Creation of Accounts and Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

7.13 Summary of Diagnostics Agent Users and Groups on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

7.14 Performing a Domain Installation Without Being a Domain Administrator. . . . . . . . . . . . . . . . . . . . . 79

A

Appendix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

A.1 Online Information from SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

A.2 Using PowerShell. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Installation of Diagnostics Agent on Windows Content

PUBLIC

3

1 Introduction

This guide explains how to install a Diagnostics Agent for SAP Solution Manager.

This guide is part of a global installation and configuration procedure which is described in the document How to Use SAP Solution Manager Configuration (SOLMAN_SETUP) (reference is provided at Online Information from SAP [page 81]).

Caution

Before you start the implementation:

? Make sure you have the latest version of this document, which can be downloaded from: http://

support.sltoolset

Installation Option of Software Provisioning Manager Installation

Guides - Standalone Engines and Clients Diagnostics Agent

? Check SAP Note 1858920 : Diagnostics Agent installation with the software provisioning manager,

for issues that may exist with this version of the installer, and for corresponding solutions.

Naming Conventions

? Diagnostics Agent

SAP Solution Manager Diagnostics Agent is the remote component of End-to-End Root Cause Analysis. It allows having a connection between SAP Solution Manager and the Managed System(s), and then to collect information from the Managed Systems for reporting purposes.

? FQN

Abbreviation for Fully Qualified Name (for example host.domain.corp and not the short host name host).

? Managed System

Term for a satellite system (for example, an AS ABAP or SAP NetWeaver AS for Java system) managed by SAP Solution Manager.

Variables

Variables

Description

Diagnostics Agent system ID in uppercase letters.

Diagnostics Agent system ID in lowercase letters.

Fully Qualified Name (host.domain.corp and not the short host name host).

Instance Number of a Diagnostics Agent.

4

PUBLIC

Installation of Diagnostics Agent on Windows Introduction

Variables

Description

Operating System name.

The system ID of an arbitrary SAP system in uppercase letters, possibly, but not necessarily a Diagnostics Agent system ID. In this guide is only used in situations where also non Diagnostics Agent system IDs are meant, for example in section Diagnostics Agent System ID and Instance Number [page 16].

The system ID of an arbitrary SAP system in lowercase letters, possibly, but not necessarily a Diagnostics Agent system ID. In this guide is only used in situations where also non Diagnostics Agent system IDs are meant.

Constraints

? Effective immediately, the software provisioning manager no longer supports the deprecated Windows

operating system versions 2998013 listed in SAP Note 2998013 .

Note

? If your current operating system is listed as deprecated in SAP Note 2998013 , we strongly

recommend that you migrate to a supported platform.

? If you continue to run Software Provisioning Manager on the deprecated Windows operating

system versions listed in SAP Note 2998013 , you do so at your own risk and without support from SAP. The software provisioning manager 1.0 SP39 and higher will still run on the deprecated Windows operating system versions listed in SAP Note 2998013 but it may run into an error. When you start the software provisioning manager, you will see a warning like the following: "Platform Support : Support for SAP JVM on Windows Server 2012 (R2) ends October 31th, 2023. See SAP note 2998013." If you run into an issue, you must use the "frozen" software provisioning manager 1.0 SP38 software and the related installation guide. For more information, see SAP Note 3346502 .

? Effective immediately, the software provisioning manager no longer supports the deprecated operating

system versions 2998013 listed in SAP Note 2998013 .

Note

? If your current operating system is listed as deprecated in SAP Note 2998013 , we strongly

recommend that you migrate to a supported platform.

? If you continue to run Software Provisioning Manager on the deprecated operating system versions

listed in SAP Note 2998013 , you do so at your own risk and without support from SAP. The software provisioning manager 1.0 SP36 and higher will still run on the deprecated operating system versions listed in SAP Note 2998013 but it may run into an error. When you start the software provisioning manager, you will see a warning like the following: "Platform Support : Support for SAP JVM on Windows Server 2008 (R2) ends January 14th, 2022. See SAP note 2998013." If you run into an issue, you must use the "frozen" software provisioning manager 1.0 SP35 software and the related installation guide. For more information, see SAP Note 3220901 .

Installation of Diagnostics Agent on Windows Introduction

PUBLIC

5

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download