Installation of Diagnostics Agent on Windows

Installation Guide | PUBLIC

Software Provisioning Manager 1.0 SP40

Document Version: 40.0 ¨C 2024-02-12

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

Installation of Diagnostics Agent on Windows

THE BEST RUN

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. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

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. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

2.9

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

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

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

Operating System Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

SAP Solution Manager Connectivity Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

3

Preparation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

3.1

Preparation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

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

3.2

SAP Directories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

3.3

Using Logical Host Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Using Virtual Host Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

3.4

Preparing the Installation Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

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

Media Required for the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Archive-Based Diagnostics Agent Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Downloading Complete Installation Media. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

3.5

Patching the Installation Media. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

3.6

Diagnostics Agent Download Paths. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33

4

Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34

4.1

Installation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34

2

PUBLIC

Installation of Diagnostics Agent on Windows

Content

4.2

Prerequisites for Running Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34

4.3

Running Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

4.4

Additional Information about Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Useful Information about Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

How to Avoid Automatic Logoff by Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . 42

Restarting Interrupted Processing of Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . 43

Troubleshooting with Software Provisioning Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Using the Step State Editor (SAP Support Experts Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

5

Unattended Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

5.1

Unattended Installation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49

5.2

Unattended Archive-Based Diagnostics Agent Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

5.3

Preparing an Unattended Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

5.4

Running an Unattended Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

5.5

Running an Unattended Uninstallation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

5.6

Troubleshooting an Unattended Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

6

Post-Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

6.1

Post-Installation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

6.2

Ensuring User Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

6.3

Complying with SAP Solution Manager Security Guidelines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

7

Additional Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

7.1

Installation Guidance for Experienced Administrators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

7.2

Installing the Diagnostics Agent Optionally with the SAP System. . . . . . . . . . . . . . . . . . . . . . . . . . . 63

7.3

Using the SMD Setup Script. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

7.4

Changing the Log Level. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

7.5

Starting and Stopping the SAP System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

7.6

Uninstalling an SAP System or Single Instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70

7.7

Backup and Recovery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

7.8

Software Provisioning Manager and Diagnostics Agent Version Information. . . . . . . . . . . . . . . . . . . 73

7.9

Unsupported Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75

7.10

SAP Router. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

7.11

SAP System Security on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

7.12

Automatic Creation of Accounts and Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

7.13

Summary of Diagnostics Agent Users and Groups on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

7.14

Performing a Domain Installation Without Being a Domain Administrator. . . . . . . . . . . . . . . . . . . . .80

A

Appendix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

A.1

Online Information from SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

A.2

Using PowerShell. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

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 82]).

¯Ì 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

Guides - Standalone Engines and Clients

Diagnostics Agent

Installation

?

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).

4

PUBLIC

Instance Number of a Diagnostics Agent.

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 17].

The system ID of an arbitrary SAP system in lowercase let-

ters, 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

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 .

, we strongly

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

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

but it may run into an error. When you start

system versions listed in SAP Note 2998013

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

, we strongly

PUBLIC

5

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

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

Google Online Preview   Download