Академический Документы
Профессиональный Документы
Культура Документы
Introduction
What is needed and where ?
Choose Diagnostics Agent or Agents On-the-fly
Diagnostics Agents
Agents On-the-fly
Landscape Examples
SAP Host Agent
Diagnostics Agent Characteristics
Diagnostics Agents are SAP Systems
Latest Diagnostics Agent Releases
Diagnostics Agent Release Characteristics
Diagnostics Agent and SLD Registration
Diagnostics Agent Mass Installation
Diagnostics Agent Maintenance Procedures
Diagnostics Agent Upgrade/Replacement/Removal
Scope
The following rules apply to Solution Manager 7.2.
Terminology
The term ‘host’ in this slide set does not designate network alias. Hosts must have
their own IP addresses.
A ‘virtual host’ designates a simulated host running for example on top of a VMware.
A ‘logical host’ designates a network/host configuration which associates a physical
host with one or more additional host names and dedicated IP addresses. This is
used, for example, to move systems from one physical host to another.
N.B.: To find the host name of an ABAP system, use transaction sm51, and for Java
systems refer to the System Info Web page.
Agent installations
Install Diagnostics Agents as usual, using the SWPM.
Decide to operate either classic Diagnostics Agents or Agents On-the-fly, depending on each
host topology. Agents On-the-fly enabling is done with SOLMAN_SETUP (See above doc).
Note: It is not necessary to replace existing Diagnostics Agents, that were installed using a
“logical hostname”, except in the logical hostname is subject to move (specifically in High
Availability environments).
Rule #1:
Install the required number of Diagnostics Agents
In the context of each Solution Manager System use only one Diagnostics Agent or one
Agent On-the-fly per managed host. Managed hosts are primarily logical hosts, or if not
applicable physical/virtual hosts (as shown on the next slides)
Each Diagnostics Agent or Agent On-the-fly manages, on behalf of one Solution Manager,
the systems/components running on the host on which it is running (and represents that host)
– following slides explain which systems/components are supported
– repeat the “Managed System Configuration” (solman_setup) on each Solution Manager for each
Technical System running on these hosts (logical host, or if not applicable physical/virtual host).
Activities “Byte Code Adapter Installation” and “Introscope Host Adapter” have to be performed only in
one “leading” Solution Manager system (see page 12)
For landscapes with logical host names and in case Agents On-the-fly are not used,
specify the the logical host name during Diagnostics Agent installations.
When installing an (additional) Agent for a logical host, using the Diagnostics Agent installation
package, provide the short host name in the Software Provisioning Manager step "Diagnostics Agent
Host".
Rule #1 (details):
Install required number of Diagnostics Agents (not applicable in context of Agents On-the-fly)
C1 C2 C7 C8 C3 C4 C5 C6
Rule #1 (continued):
How to use Agents On-the-fly (available since Solution Manager 7.1 SP05)
Mandatory context:
– Managed systems in High Availability environments
– Physical or virtual hosts running a high number of logical hosts (outside High Availability environments)
Use case:
Rule #1 (continued):
How to use Agents On-the-fly (available since Solution Manager 7.1 SP05)
Preparation
– Remove existing Diagnostics Agents at Physical, virtual and logical host level (in affected landscape).
Pay attention to recommendations for Diagnostics Agents Removal, to avoid potential Java managed
system startup failures (see rule #6).
– Install Diagnostics Agents only at Physical or virtual host level, without specifying any logical host
name, using latest Diagnostics Agent installation package. See SAP note 1833501.
Rule #1 (continued):
How to use Agents On-the-fly (available since Solution Manager 7.1 SP05)
Configuration
Diagnostics Agent Configuration:
– Start the “Host configuration” for each Physical or virtual host
Available under solman_setup / Managed System Configuration / Hosts
– Especially enable the “Agents On-the-fly” feature within step “Enter System Parameters”
Adjust exclusion filters to have only relevant logical hosts, before pressing save button.
Logical host filtering-impact simulation is available via “Display resulting host list” button.
Defining appropriate filters will avoid having “irrelevant” Agents On-the-fly instantiated.
Agents On-the-fly get instantiated by the Diagnostics Agent running on the Physical or virtual Host,
as soon as the “Enter System Parameters” step is saved.
Java Instance
+ ABAP Central Services + ABAP Central Services
Java Instance
DB DB
DB
Diagnostics Agent
Java Dialog Instance ABAP Dialog Instance
Diagnostics Agent
Java Central Services ABAP Central Services
Possible since Solution
Manager 7.1 SP08 DB Diagnostics Agent Diagnostics Agent
Diagnostics Agent Possible since Solution Possible since Solution
Manager 7.1 SP08 DB Manager 7.1 SP08 DB
Diagnostics Agent Diagnostics Agent
(1) In the context of High Availability environments consider to use the Agents On-the-fly feature available since Solution Manager 7.1 SP05
© 2020 SAP AG. All rights reserved. 11
What is needed and where? (Diagnostics Agent/Agents On-the-fly)
Covering 3-system landscape: Enable full RCA of QA Portal managed system on both SolMans,
by installing an additional Diagnostics Agent
Solution Manager
and extracting QA Portal performance data
Dev SolMan
IMPORTANT Collected config. of from Prod IS Enterprise Manager (IS EM)
On the Dev SolMan, when
managed systems
running SOLMAN_SETUP /
“Managed System Dev & QA
Configuration” for the QA Dev Enterprise Portal Introscope
Portal managed system, Comparison possible Adapters
mark the activities “Byte
3-System landscape
Diagnostics Agent
Code Adapter Installation”
Dev Introscope
and “Introscope Host
Adapter” as “Postponed”. Enterprise Manager
Dev SolMan
Collected config. of
IMPORTANT managed systems
On the Prod IS EM host, install a Dev & QA Dev Enterprise Portal
second Diagnostics Agent, using
3-System landscape
a distinct System ID (SID). Also
pay attention to potential file
permission conflicts. For
instance, the Prod Agent OS user Dev Introscope
will at one point in time update the Enterprise Manager
Prod IS EM config files (via
SOLMAN_SETUP transaction).
Diagnostics Agent
So, inappropriate file access
permissions prevent the second QA Enterprise Portal
Dev Agent OS user from creating
new files, or reading the file during Solution Manager
the Prod IS EM configuration
Prod SolMan
import.
Collected config. of
The OS user group (sapsys on managed systems
Unix, or SAP_LocalAdmin QA & Prod
on Windows) must have write
permissions on the IS EM install
path and content. On Unix, OS Prod Enterprise Portal
users need at least umask 027. Prod Introscope
Enterprise Manager
Note: Windows OS users are like Diagnostics Agent
SAPService<AgentSID>.
On Unix <AgentSID>adm. Diagnostics Agent
© 2020 SAP AG. All rights reserved. 13
What is needed and where? (Diagnostics Agent/Agents On-the-fly)
Solution Manager
E2E Trace Analysis Prod Enterprise Portal Introscope Prod ECC Server
Adapters
Diagnostics Agent Diagnostics Introscope
Prod Introscope
Agent Adapter
Enterprise Manager
Rule #2:
Have up-to-date SAP Host Agents
See details in SAP SCN wiki:
http://wiki.scn.sap.com/wiki/display/SMSETUP/Diagnostics+Agent+Maintenance+Procedures
Rule #3:
The Diagnostics Agent is a standard SAP system
The same rules apply as for any standard SAP system
Do not install an Agent in the directory structure of another SAP system (or copy or move
the files)
– Agents must be independent of any other system installation
Several Diagnostics Agents can be installed using the same SID, but different instance
numbers, in case they use the same kernel.
– The agent SID must contain only Diagnostics Agent instances
Rule #3 (details):
Alternatives for installing multiple Diagnostics Agents on the same host
These Agents have to be connected to different Solution Manager systems
Rule #4:
Use the latest SWPM 1.0 version, when installing a new or an additional
Diagnostics Agent.
See details in SAP SCN wiki:
http://wiki.scn.sap.com/wiki/display/SMSETUP/Diagnostics+Agent+Maintenance+Procedures
Installed with NW products based on … SWPM 1.0 SP04 and higher (2)
JVM SAPJVM 8
(1) Also allows to configure the trusted connection @ SAP Host Agent level, automatically.
(2) For more information refer to SAP Note 1833501.
New SLD registration strategy (since SAP Solution Manager 7.2 SP09)
When performing a Diagnostics Agent installation and using a SDMA SAR-File >= 7.20
SP09, SLD connection details can no longer be entered.
Per Software Provisioning Manager 1.0 SP7 (November 2014), a new, simpler version is
available. (see SAP note 1858920 / SWPM 1.0 SP7).
Rule #5:
For upgrade/replacement of Diagnostics Agents see details in SAP SCN wiki:
http://wiki.scn.sap.com/wiki/display/SMSETUP/Diagnostics+Agent+Maintenance+Procedures
Rule #6:
For removal of Diagnostics Agents see details in SAP SCN wiki:
http://wiki.scn.sap.com/wiki/display/SMSETUP/Diagnostics+Agent+Maintenance+Procedures