Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Public
Agenda 1/2
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
Agenda 2/2
Diagnostics Agent and SLD Registration
Diagnostics Agent Mass Installation
Diagnostics Agent Maintenance
Diagnostics Agent Upgrade
Diagnostics Agent Replacement
Diagnostics Agent Removal
Introduction
Scope
The following rules apply to both Solution Manager 7.0 EhP1 and 7.1, unless they are
tagged [7.0 EhP1 only] or [7.1 only]
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.
Existing installations
Previous Diagnostics Agent installation process is still valid.
Operate either classic Diagnostics Agents or Agents On-the-fly, depending on each Managed
system environment.
Diagnostics Agent installations already in place are still valid and do not necessarily need to
be replaced by the Agent On-the-fly feature. Nevertheless in High Availability environments it
could be of interest to put Agent On-the-fly in place.
Rule #1:
Install the required number of Diagnostics Agents
In the context of each Solution Manager System use only one Diagnostics Agent or 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 what is a supported systems/components
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 10)
For landscapes with logical host names and in case Agents On-the-fly are not used,
specify, during the Diagnostics Agent installation, each time the logical host name
When installing an (additional) Agent for a logical host, using the Diagnostics Agent installation
package, provide the short hostname, in the SAPInst step requesting a Virtual host name.
LogicalHost1
LogicalHost3
C1
C2
Diagnostics
Agent 1
SAP Host
Agent
C7
C8
C3
Diagnostics
Agent 2
LogicalHost2
C4
C5
Diagnostics
Agent 3
Diagnostics
Agent 4
PhyHost2
or VMware
C6
PhyHost3
or VMware
SAP Host
Agent
Diagnostics
Agent 5
SAP Host
Agent
.
.
DA
Diagnostics Agent
HA
PhyHost1 or VMware
Use case:
10
DB
Diagnostics Agent
Enterprise Portal
Solution Manager
Example where all components run with one hostname (physical, virtual or logical)
Central Instance
Dialog Instance
Central Services
DB
Diagnostics Agent
Central Instance
+ ABAP Central Services
Dialog Instance
DB
Diagnostics Agent
11
Enterprise Portal
Example where each component runs with different hostnames (physical, virtual or logical)
DB
Diagnostics Agent
Central Instance
Diagnostics Agent
Dialog Instance
Diagnostics Agent
DB
Diagnostics Agent
(1) Agent required in the
scope of Solution Manager 7.1
Central Instance
Diagnostics Agent
Dialog Instance
Diagnostics Agent
DB
Diagnostics Agent
(1) Agent required in the scope
of Solution Manager 7.1
In the context of High Availability environments consider to use the Agents On-the-fly feature available since Solution Manager 7.1 SP05
12
Use Prod IS EM to
retrieve perf. data of
QA Managed systems
managed systems
Dev & QA
Comparison possible
Diagnostics Agent
Dev Introscope
Enterprise Manager
Solution Manager
Diagnostics Agent
Collected config. of
managed systems
QA & Prod
Diagnostics Agent
Introscope
Adapter
Comparison possible
Prod Introscope
Enterprise Manager
3-System landscape
Prod SolMan
Dev SolMan
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 perf. data
from Prod. IS Enterprise Manager
IMPORTANT
Collected config. of
Diagnostics Agent
13
Solution Manager
Collected config. of
managed systems
Dev & QA
Dev Introscope
Enterprise Manager
Diagnostics Agent
QA Enterprise Portal
Solution Manager
Prod SolMan
IMPORTANT
On the Prod. IS EM host,
install a second Diagnostics
Agent instance, re-using the
System ID (SID) of the
Diagnostics Agent installed
initially.
Collected config. of
managed systems
QA & Prod
Prod. Introscope
Enterprise Manager
3-System landscape
Dev SolMan
[7.1 only] 3-system landscape requires a 2nd Diagnostics Agent (Prod. IS EM)
Diagnostics Agent
Diagnostics Agent
14
3-system landscape
(continued)
Prod SolMan
Managed systems
in a given E2E solution
(Per Dev, QA or Prod type)
must be connected to the
same Solution Manager
system
Adapters
Diagnostics Agent
Diagnostics Introscope
Adapter
Agent
QA System landscape
QA Enterprise Portal Introscope
QA ECC Server
Adapters
Diagnostics Agent
Diagnostics Introscope
Adapter
Agent
Solution Manager
Prod Managed
Systems data
EP & ECC
E2E Trace Analysis
Prod Introscope
Enterprise Manager
Adapters
Diagnostics Agent
Diagnostics Introscope
Adapter
Agent
15
Rule #2:
Have up-to-date SAP Host Agents
See SAP note 1365123 text for the current minimum version
This note also confirms whether the SAP Host Agent version installed or updated during the installation
of the Diagnostics Agent covers has currently known defects.
Install a SAP Host Agent if none has yet been installed (one per physical host)
Check whether there is a SAP Host Agent using the following path:
o For Windows look under: "%ProgramFiles%"\SAP\hostctrl
o For Unix, under: /usr/sap/hostctrl/
Update the SAP Host Agent according to SAP note 1031096, if the version is not sufficient
Check version at OS level (looking in the output at SAPHOSTAGENT Information):
o For Windows: "%ProgramFiles%"\SAP\hostctrl\exe\saphostctrl -function ExecuteOperation -name versioninfo
o For Unix: /usr/sap/hostctrl/exe/saphostctrl -function ExecuteOperation -name versioninfo
[7.1 only] Currently installed Host Agent version is also visible in the host browsing, if Managed System
Configuration has been performed with solman_setup
o Navigate to Solution Manager Administration work center -> Select Landscape + Technical System
selection type -> System Details -> System Details -> Hosts -> <search for your host> -> Host Status
2013 SAP AG. All rights reserved.
16
Rule #2 (continued):
Have up-to-date SAP Host Agents
Implement automatic upgrade process (especially if you plan an update)
SAP note 1473974 describes ways to upgrade centrally and automatically, running SAP Host Agents.
17
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
18
Rule #3 (details):
Alternatives for installing multiple Diagnostics Agents on the same host
These Agents have to be connected to different Solution Manager systems
Use the same dedicated System ID (and different instance numbers)
Exception: Do not use a same SID for Diagnostics Agents with different kernel releases (this is
prevented by the latest installers).
19
Global exe
/usr/sap/<SMDSID>/exe
/usr/sap/<DASID>/SYS/exe
SAPJVM
/usr/sap/<DASID>/SYS/exe/jvm
global directory
/usr/sap/<SMDSID>/SYS/global
/usr/sap/<DASID>/SYS/global
profile directory
/usr/sap/<SMDSID>/SYS/profile
/usr/sap/<DASID>/SYS/profile
Instance directory
/usr/sap/<SMDSID>/J<XX>
/usr/sap/<DASID>/SMDA<XX>
script directory
/usr/sap/<SMDSID>/J<XX>/script
/usr/sap/<DASID>/SMDA<XX>/script
work directory
/usr/sap/<SMDSID>/J<XX>/work
/usr/sap/<DASID>/SMDA<XX>/work
Local exe
/usr/sap/<DASID>/SMDA<XX>/exe
Local SAPJVM
No SAPJVM
/usr/sap/<DASID>/SMDA<XX>/exe/sapjvm_xx (1)
/usr/sap/<SMDSID>/J<XX>/SMDAgent
/usr/sap/<DASID>/SMDA<XX>/SMDAgent
Agent logs
/usr/sap/<SMDSID>/J<XX>/SMDAgent/log
/usr/sap/<DASID>/SMDA<XX>/SMDAgent/log
(1)
(1)
Contains executable kernel programs that are replicated (files moved for the SAPJVM) from SYS/exe at
the time the Diagnostics Agent instance is started, in case the files have been updated.
20
Rule #4:
Use the latest SWPM 1.0 (SP04 Patch 2 or higher),
when installing a Diagnostics Agent to comply with rule #3. See SAP note 1858920.
A summary of Diagnostics Agents releases and characteristics is available on the next slide
With Solution Manager release lower than 7.0 EhP1 SP20 only use older Diagnostics
Agent release 7.01 SR1.
This Diagnostics Agent release is installable with the help of the SAP EhP1 for SAP
NetWeaver 7.0 Installation Master, Kernel & Java DVDs. A separately installed JDK 1.4.2 is
also required.
21
7.20
7.30 SP03
Compatible with
Solution Manager
Solution Manager
lower than 7.0 EhP1
SP20 (1)
Solution Manager
since 7.0 EHP1 SP20
(included) (1)(2)
Solution Manager
since 7.0 EHP1 SP20
(included) (1)(2)
Solution Manager
since 7.0 EHP1 SP20 (included)
(1)(2)
Supported NW
Managed system
releases
Installation
SAP note
1357812
1368413
1833501
PAM documentation:
https://service.sap.com/sltoolset
/ Software Logistics Toolset 1.0
/ PAM
In PAM document, navigate to
Software Provisioning Manager
1.0 / SAP Solution Manager
Diagnostics Agent
Installer recommended
when new installation required
(See OS platform support on next slide)
(1)
When a Solution Manager system is upgraded, the Diagnostics Agents do not generally need to be upgraded manually.
See next slide and rule #5. IMPORTANT: Rule #2 must be followed.
(2)
N.B.: This Diagnostics Agent release is also applicable to Solution Manager 7.1.
22
7.11
7.20
7.30 SP03
Standalone (2)
Latest Agent
release (2)
7.11
7.20 / patch 36
JVM
SAPJVM 5
SAPJVM 6
SAPJVM 6
SAPJVM 6
Default System ID
/ Instance Number
DAA
/ SMDA<97 to 00>
DAA
/ SMDA<97 to 00>
DAA
/ SMDA<97 to 00>
DAA
/ SMDA<98 to 00>
No
Yes
Yes
Yes
No
Yes (1)
Yes
Yes
Install manually
Auto-installed
Auto-installed/updated
(2)
Auto-installed/updated
(2)
1234387
1368413
1829024
1858920
Agent start/stop/control
Standard
Standard
Standard
Standard
(1)
(2)
(3)
23
24
25
Use the unattended mode to silently install Diagnostics Agents for large
consistent landscapes
For Diagnostics Agent releases specific details
see SAP note 1833501 / Mass Deployment Notes
26
Rule #5:
No need to upgrade Diagnostics Agents (in contrast to SAP Host Agent)
Diagnostics Agents take their business logic (software) from the Solution Manager system
to which they are connected
All Diagnostics Agents running and connected in the landscape are centrally patched by applying an LMSERVICE Java Software Component Archive on the Solution Manager system
Diagnostics Agent Installation SAP notes include a guide and simple manual procedures
needed to resolve known punctual issues (support of cryptography, ). Alternatively, use
the later described Agent replacement procedure.
Some OS platform constraints might require a Diagnostics Agent Kernel upgrade. See SAP
note 1707141.
27
Rule #5 (continued):
To replace a Diagnostics Agent uninstall the previous Agent and install the
new required release:
Reset server name
Login to the Solution Manager system
to which the agent to be upgraded is connected
Navigate to the Agent Administration and note the
server name of the old agent
Reset server name using the context
menu of the agent, and stop the agent
Install new Diagnostics Agent release using a different SID (no upgrade tool available)
Assign the same Server Name to the new Agent using the smdsetup script
(see details in the Diagnostics Agent troubleshooting guide).
Java based Managed systems require to take some specific IMPORTANT actions (see next slides)
Uninstall the previous Diagnostics Agent using SAPInst
2013 SAP AG. All rights reserved.
28
29
Rule #6:
To remove a Diagnostics Agent instance installed for a specific hostname:
In case the solman_setup Ensure HA virtualization compatibility option was used in the
past to setup the Byte Code Adapter of the Java Managed System(s) running on that host
Optionally: Uninstall also the Byte Code Adapter by removing the JVM parameters listed in SAP note
797147
Else, take the following actions (in case the Ensure HA virtualization compatibility option
was not used in the past during the solman_setup Managed System Configurations):
IMPORTANT: Remove JVM parameters listed in SAP note 797147 on the Java Managed System
used to start/run the Introscope Byte Code Adapter.
Finally restart the Java Managed system to no longer run the Introscope Byte Code Agent
The Managed System JVM parameters (to be removed) show that the Introscope Byte Code Adapter
executed inside the Managed System uses files from Diagnostics Agent directory structure:
Xbootclasspath/p:D:/usr/sap/DAA/SMDA77/SMDAgent/applications.config/com.sap.smd.agent.application.wily/BytecodeAgent/ISAGENT.8.2.3.5-2011-0114/wily/connectors/AutoProbeConnector.jar;D:/usr/sap/DAA/SMDA77/SMDAgent/applications.config/com.sap.smd.agent.application.wily/BytecodeAgent/ISAGENT.8.2.
3.5-2011-01-14/wily/Agent.jar
Run the Diagnostics Agent installer SAPInst, to uninstall the Diagnostics Agent
2013 SAP AG. All rights reserved.
30