Professional Documents
Culture Documents
Outside Discovery: User Guide Troubleshooting Guide
Outside Discovery: User Guide Troubleshooting Guide
1 SP05
Outside Discovery
User Guide
Troubleshooting Guide
Contents
1 Overview .............................................................................................................................................. 5
2 Pre-requisites ...................................................................................................................................... 6
2.1 SAPHostAgent .............................................................................................................................. 6
2.1.1 SAPHostAgent Version ............................................................................................................ 6
2.1.2 SAPHostAgent Porttype ........................................................................................................... 7
2.1.3 SAPHostAgent Trusted Connection ......................................................................................... 8
2.2 Diagnostics Agent ......................................................................................................................... 8
3 User Guide ........................................................................................................................................... 9
3.1 Host Discovery .............................................................................................................................. 9
3.1.1 Landscape Browser / Technical System Editor View ................................................................ 9
3.1.2 Host Discovery Process Status .............................................................................................. 11
3.1.3 Physical Host Data ................................................................................................................. 11
3.1.4 Logical Host Data ................................................................................................................... 12
3.2 Database Discovery .................................................................................................................... 13
3.2.1 Landscape Browser ............................................................................................................... 13
3.3 Microsoft IIS Discovery............................................................................................................... 14
3.3.1 Landscape Browser / Technical System Editor View .............................................................. 14
4 Support Tools .................................................................................................................................... 16
4.1 Landscape browser .................................................................................................................... 16
4.1.1 Landscape Tab Hosts View ............................................................................................... 16
4.1.2 Administration Tab Logs and Traces View ......................................................................... 16
4.2 Diagnostics Agent Administration ............................................................................................. 18
4.2.1 Agent Error Monitoring Tab .................................................................................................... 18
4.2.2 Agent Log Viewer ................................................................................................................... 18
4.3 Diagnostics Agent Support ........................................................................................................ 20
4.3.1 SMD Server Analysis View..................................................................................................... 20
4.3.2 Diagnostics Agent Runtime View ........................................................................................... 21
5 Troubleshooting Guide ..................................................................................................................... 22
5.1 Troubleshooting Roadmap ......................................................................................................... 22
Outside Discovery 4
User Guide SolMan 7.1 SP05
SAP AG 2008
Outside Discovery 5
User Guide SolMan 7.1 SP05
1 Overview
The purpose of the Outside Discovery is to automatically discover, collect and send information related the monitored
system to Solution Manager.
As of Solution Manager 7.1 SP06, Outside Discovery is able to collect following information:
Host: data related to Physical Host and Virtual Host (like Operating System type, version, cpu, memory
)
Database: data related to installed database (like database type, version, )
Microsoft Internet Information Service: data related to installed instance of Microsoft IIS (like .Net
version, IIS Applications, IIS Sites)
The Outside Discovery is packaged inside the Diagnostics Agent within the Agelet called DCC (agelet archive:
sap.com~tc~smd~agent~application~e2edcc.ear).
The Outside Discovery process relies on the SAPHostAgent Web Service process for collecting all raw technical
data related to monitored system.
The process is ready to push as soon as the running Diagnostics Agent gets connected to a Solution Manager
system. Data are:
o Collected from the SAPHostAgent Web Service.
o Filtered and cached on Agelet side.
o Sent to JAVA Bean Controller (SMD_DataEnrichment_Registrator) through P4 Connection.
o Stored in LMDB database (AI_DIAGSNOTICS_DATA_ENRICHMENT package).
SAP AG 2008
Outside Discovery 6
User Guide SolMan 7.1 SP05
2 Pre-requisites
Even if the Outside Discovery process itself do not require any specific setup in order to run some pre-requisites are
necessary.
Pre-requisites for the SAPHostAgent and Diagnostic Agent are detailed in the Solution Manager Guided Procedure:
SAP Solution Manager Configuration System Preparation Step 6.3: Prepare Outside Discovery
Implementation Guides (IMG) are available in Solution Manager.
Topic IMG ID
2.1 SAPHostAgent
All data discovered by the Outside Discovery process are collected from the SAPHostAgent installed on the physical
host.
A specific self-check for the SAPHostAgent version is implemented in within the Self-Check Framework. This
check verify that the current SAPHostAgent Patch Number is higher than the required Path Number defined in
following configuration:
SAP AG 2008
Outside Discovery 7
User Guide SolMan 7.1 SP05
SAP AG 2008
Outside Discovery 8
User Guide SolMan 7.1 SP05
SAP Solution Manager Configuration System Preparation Step 6.4: Connect Diagnostics Agents
SAP AG 2008
Outside Discovery 9
User Guide SolMan 7.1 SP05
3 User Guide
As soon as the Diagnostics Agent gets connected to a Solution Manager system, the Outside discovery agelet
starts running.
The Outside Discovery Agelet contains 3 different jobs:
Host Discovery: this job is retrieving data from physical and virtual host on the monitored system.
Database Discovery: this job is retrieving data for all installed database on the monitored host.
IIS Discovery: this job is retrieving data for installed Microsoft IIS on monitored host.
The Host Discovery process is the master process of the Outside Discovery Agelet. Database
Discovery and IIS Discovery processes are only started if Host Discovery has been able to
successfully push and create host entity on Solution Manager.
In the following example, Outside Discovery retrieved following information from a Diagnostics Agent installed
on physical host vml2262:
Landscape browser:
SAP AG 2008
Outside Discovery 10
User Guide SolMan 7.1 SP05
SAP AG 2008
Outside Discovery 11
User Guide SolMan 7.1 SP05
Here is a view of the Host Discovery Process running on Physical Host vml2262
OpSysUname Windows NT
OpSys WINDOWS_X86_32
OpSysRelease 5.2
SAP AG 2008
Outside Discovery 12
User Guide SolMan 7.1 SP05
OsSysBits 32
OpSysCategory Windows NT
OpSysReleaseName Windows NT 5.2
Manufacturer PC Vendor
PhysicalRAMinMB 3904
VirtualRAMinMB 12276
NumberofCPUs 4
CPURate 2799
CPUCache
CPUType Intel 801586 (Mod 2 Step 9)
The Logical Host inherits from the same Operating System data as its Physical Host.
SAP AG 2008
Outside Discovery 13
User Guide SolMan 7.1 SP05
SAP AG 2008
Outside Discovery 14
User Guide SolMan 7.1 SP05
In the Landscape Browser you can search for all IIS instances
SAP AG 2008
Outside Discovery 15
User Guide SolMan 7.1 SP05
SAP AG 2008
Outside Discovery 16
User Guide SolMan 7.1 SP05
4 Support Tools
Different tools are available in Solution Manager in order to identify problems during the Outside Discovery process.
Example of error occurring during Host discovery process of Physical Host nced60165205a:
SAPHostAgent is too old Upgrade is necessary.
Host Discovery Push Host <hostname> Search pattern for Host Discovery job on specific
hostname.
Database Discovery Push Database <SID> at <hostname> of Search pattern for Database discovery job on specific
type <database type> hostname.
IIS Discovery Push MSIIS IIS.SystemHome.<hostname> Search pattern for IIS discovery job on specific
hostname.
SAP AG 2008
Outside Discovery 17
User Guide SolMan 7.1 SP05
The level of details (Error, Warning, Info and Debug) is managed in Administration Tab Configuration Log
Configuration.
SAP AG 2008
Outside Discovery 18
User Guide SolMan 7.1 SP05
Following locations are available for filtering the Outside Discovery jobs:
SAP AG 2008
Outside Discovery 19
User Guide SolMan 7.1 SP05
SAP AG 2008
Outside Discovery 20
User Guide SolMan 7.1 SP05
The JAVA Bean Controller is used to controlled callback performed by each Outside Discovery Agelet.
If the object is not registered correctly, use the objects Reinitialization button to re-create all objects.
SAP AG 2008
Outside Discovery 21
User Guide SolMan 7.1 SP05
SAP AG 2008
Outside Discovery 22
User Guide SolMan 7.1 SP05
5 Troubleshooting Guide
Section
Tool Check
reference
Once the problem has been identified, please check in the Common Issues (section 5.2) for detailed description of the
root cause and possible solution.
If the problem is not listed in the Common Issues section, please create a Message attaching the logs file from the
Diagnostics Agent.
SAP AG 2008
Outside Discovery 23
User Guide SolMan 7.1 SP05
Diagnostics agent is not connected to solution manager server, connection status: CONNECTING
Diagnostics agent is not connected to solution manager server, connection status:
LAST_REGISTRATION_ON_ERROR
Description an error occurs during the communication between the Java Bean Controller and the
persistence Function Module in ABAP (package AI_DIAGNOSTICS_DATA_ENRICHMENT).
This is a global exception from the AI_DIAGNOSTICS_DATA_ENTICHMENT package and
should be resolved on Solution Manager ABAP stack.
Additional Check SOLMANDIAG destination between SAP J2EE Engine and ABAP stack.
Checks
Check ST22 dumps for additional information
SAP AG 2008
Outside Discovery 24
User Guide SolMan 7.1 SP05
Description This exception occurs when the Host Discovery process is trying to parse SAPosCol data
retrieved from the SAPHostAgent.
In some situation the SAPHostAgent is partially creating the SAPosCol.xml file before
sending it to Web Service.
Solution Apply SAP Note 1587142 SAPOscol WS Returns malformed XML response.
Additional SAPHostAgent log files should be analyzed in order to identify SAPHostAgent the issue.
Checks
Description This exception occurs when the SAPHostAgent process (Porttype SAPosCol) is not able to
provide the SAPosCol.xml file
Additional SAPHostAgent log files should be analyzed in order to identify SAPHostAgent exception.
Check
SAP AG 2008
Outside Discovery 25
User Guide SolMan 7.1 SP05
5.2.6 CIM Request EnumerateInstances for classes Application failed: : Provider load
failure
Description The issue is the restriction done by II 7.0 on Windows 2008 and higher while discovering IIS
Applications in WMI namespace. Additional information available at
http://learn.iis.net/page.aspx/162/managing-sites-with-iis-7039s-wmi-provider/.
You must be an administrator to connect to the Web Administration WMI namespace. This
means that you are logged in as one of the following:
The built-in Administrator account on Windows Server 2008
A member of the Administrators group and you have disabled User Account Control
(UAC)
A member of the Administrators group and UAC is enabled.
Description SAPHostAgent user does not have authorization to access ADSi IIS object.
Description A timeout exception occurred while accessing one of the SAPHostAgent Web Service
methods.
Additional SAPHostAgent log files should be analyzed in order to identify SAPHostAgent performance or read
SAP AG 2008
Outside Discovery 26
User Guide SolMan 7.1 SP05
check issue.
Description A timeout exception occurred while accessing the SAPHostAgent Web Service (Porttype
SAPosCol)
Additional SAPHostAgent log files should be analyzed in order to identify SAPHostAgent performance or read
check issue.
5.2.10 Error to perform http request cause Socket output stream shutdown by peer
Description The SAPHostAgent has closed the communication channel with Diagnostics Agent.
Additional SAPHostAgent log files should be analyzed in order to identify SAPHostAgent performance or read
check issue.
Cannot established a trusted connection to SAP host agent webservice. (SAP Host agent version
installed doesn't support trusted connection method)
<SAPHostAgentTrustedConnectionConfigurator.java:117:setupTrustedConnection()>
SAP AG 2008
Outside Discovery 27
User Guide SolMan 7.1 SP05
Cannot established a trusted connection to SAP host agent webservice. (Cannot find the file
/usr/sap/hostctrl/work/sapcontrol_logon/logon5.)
Cause: It means that the SMD Diagnostics agent does not have enough permissions to read the folder
"/usr/sap/hostctrl/work/sapcontrol_logon/logon5"
Description The Diagnostics Agent does not have enough permissions to read the folder
"/usr/sap/hostctrl/work/sapcontrol_logon/logon5"
Required Change the agent OS user so that it can read the folder.
Action
Description One of the service Porttype of the SAPHostAgent is not available or not setup correctly.
Additional SAPHostAgent log files should be analyzed in order to identify SAPHostAgent performance or read
Check issue.
SAP AG 2008
Outside Discovery 28
User Guide SolMan 7.1 SP05
When running the Managed System Wizard, the following error is displayed:
The definition of Technical System SYS~XXX is not correct: SYS~XXX: Operating System <Any operating
system> of Host hostXXX must have at least one Software Component Version.
Description The Software Component Version of the Operating System is mandatory for some setup
steps.
This information is retrieved by the Host Outside Discovery Process. All pre-requisites action
regarding the Outside Discovery process should be completed before running the Setup.
Required In order to check that the Host Outside Discovery Process runs successfully, please check
Action the status of the host within the Landscape Browser at section 3.1.2 - Host Discovery Process
Status.
SAP AG 2008