Authors:

Victor Chang

Architecture Concept

SAP NetWeaver Java Support Tool

Document Version Status Date

1.0 Initial Draft Feb 17th, 2016

1.0.20170512182128 Current version May 24th, 2017

Template Version: ACD 3.2

Customer Release

Storage location for temporary versions this architecture concept document::

Final version:
Architecture Concept for NW AS JAVA Support Tool

Contents
1 Abstract ................................................................................................. 4
2 Boundary Conditions ........................................................................... 5
2.1 Qualities to be ensured by the Architecture (Input from Product Owner) ......... 5
2.2 Strategic Goals ............................................................................................... 5
2.3 Product Positioning ......................................................................................... 5
2.4 Scope ............................................................................................................. 5
2.5 Technology Decisions ..................................................................................... 6
2.6 Reuse ............................................................................................................. 6
3 Architecture Definition ......................................................................... 7
3.1 Client .............................................................................................................. 7
3.2 Setup .............................................................................................................. 7
4 Features ................................................................................................ 8
4.1 Exception Handling ......................................................................................... 8
4.2 Startup Trace .................................................................................................. 8
4.3 System Crash ................................................................................................. 8
4.4 System Hang .................................................................................................. 9
4.5 Software Component dependency check ........................................................ 9
5 Troubleshooting ................................................................................. 11
5.1 Logging ......................................................................................................... 11
5.2 Maintenance ................................................................................................. 11
6 Glossary .............................................................................................. 12

© Copyright SAP AG 2015 Internal/Confidential Page 2 of 12

Architecture Concept for NW AS JAVA Support Tool

i Revision Log

Version Date Who Remarks

0.1 Feb 17th, 2016 Victor Chang Initial Draft

ii Stakeholders and Roles:

Role Name
Product Owner Victor Chang
Victor Chang
Marcos Fernandes
Architect Roy Wu
Fabio Sarmento
Kiruthika S
Builds Manager Bernd Harder
Program Quality Manager Bernd Harder
IMS Representative
Project Sponsors Bernd Harder

© Copyright SAP AG 2015 Internal/Confidential Page 3 of 12

Architecture Concept for NW AS JAVA Support Tool

1 Abstract
This ACD covers the product architecture and details associated with the SAP NetWeaver AS JAVA
Support Tool. As a product architecture, this ACD covers business case, landscape, deployment,
and related issues.

© Copyright SAP AG 2015 Internal/Confidential Page 4 of 12

Architecture Concept for NW AS JAVA Support Tool

2 Boundary Conditions
2.1 Qualities to be ensured by the Architecture (Input from
Product Owner)
 No installation
 Intuitive and user friendly interface that a JAVA administrators can identify with
 Only landscape meta-data and metrics are documented and SAP data security policies are
observed
 Zero change on target Platform - NetWeaver AS JAVA

2.2 Strategic Goals

The SAP NetWeaver AS JAVA Support Tool is a supportability platform designed to host a variety
of features and tools aimed at reducing the amount of customer generated support messages (SWI)
and accelerating the time to resolve support incidents through automated data discovery and root
cause analysis. The intended users of this software include system administrators, support
engineers, consultants, developers, and product management Table 1

User Role Function

Technical Support  Incident Processing

 Information Discovery

J2EE Administrators  Pro-active Alerts

 Self-diagnosis

Consultants and COE  Service Delivery

 Pro-active Alerts

Product Group (TIP, TD,  Analytics

IMS)  Root Cause Analysis

Table 1

2.3 Product Positioning

This product is designed specifically for supporting the product SAP NetWeaver AS for JAVA with
release 7.0, 7.0X, and 7.1 or higher. The system administration can use the supportability tool to
collect necessary information in different scenario, for self-troubleshooting or provide to SAP
consultant. And the product is a standalone which means it can be used side-by-side in parallel as
other tool like SAP Solution Manager and are not dependent on each other.

2.4 Scope
The objective of this product is to provide capabilities in the following areas:
 Trace collection when there is exception.
 Trace collection when system crashed

© Copyright SAP AG 2015 Internal/Confidential Page 5 of 12

Architecture Concept for NW AS JAVA Support Tool

 Trace collection when system hang

 Trace collection when system is not able to startup
 Retrieve component information
 Trigger and collect threaddump.
 Screen recording
 Upload information to Mdoc or SFTP.
 Automatic Software Component dependency checking

2.5 Technology Decisions

Architecture Area Technologies to be Used

Clients Java FX
Presentation Layer / User Interface Java FX, HTML, Javascript, CSS
Business Logic Layer Java
Analytics / Reporting Web Service
Integration Middleware NA
Business Process Management / NA
Workflow
Data Persistency XML / SOAP
Development Environment Eclipse, NetBean
Lifecycle Management NA

2.6 Reuse

Reuse Owned by Maintenance Usage Remark / explanation

Component to be Guaranteed?
Used

WebService NetWeaver No MUST Invoke web method to run

AS JAVA command in SAPcontrol
Batchconfig NetWeaver Yes MUST Retrieve component information
AS JAVA

© Copyright SAP AG 2015 Internal/Confidential Page 6 of 12

Architecture Concept for NW AS JAVA Support Tool

3 Architecture Definition
3.1 Client
The SAP NetWeaver Java Support tool is designed to run only on a client machine and does not
have a traditional installation package. It connect to SAPControl and invoke webservice to retrieve
logs and trace, component information, instance information.
In order to connect to SAPControl, you have to provide logon credential of SIDADM user.

3.2 Setup
If there is proxy in front of the target NW AS JAVA server, you have to configure the proxy by click
“Proxy Setting”

3.3 Security
Provide an option validate or not the certificate in the login screen.
This make the tool communicates with the NW AS JAVA instance using a secure (encrypted)
communication (HTTPS).

© Copyright SAP AG 2015 Internal/Confidential Page 7 of 12

Architecture Concept for NW AS JAVA Support Tool

4 Features

4.1 Exception Handling

The exception handling has an option to record the screen, click on the check box to start record the screen,
and to record the exception you have to click on start button reproduce the issue by launching the portal.

After reproducing the issue, click on stop button, once the process complete click on continue and then select
the zip file which has all the trace then select the icon Upload FTP Secure.

4.2 Startup Trace

When you start/restart AS Java you may find the server node is still in starting phase after unusual long time.
To find the root cause for such issue click on the Startup option in the tool

4.3 System Crash

When you see J2EE crash, you can use collect the trace during the crash by click “Crashing” button.

© Copyright SAP AG 2015 Internal/Confidential Page 8 of 12

Architecture Concept for NW AS JAVA Support Tool

4.4 System Hang

When you encounter system hang, high CPU utilization, please click “Hanging” button, this will
trigger 3 threaddump on all server nodes. In the threaddump, you will try to find possible cause like
deadlock, or long processing thread.

4.5 Software Component dependency check

When you try to deploy any software component (SC) patch, it’s necessary to check its dependent
components and make sure the dependent components are deployed.
The tool provides the easiest way to find the dependency by click “SC dependency” button.

© Copyright SAP AG 2015 Internal/Confidential Page 9 of 12

Architecture Concept for NW AS JAVA Support Tool

Then you can select the target patch that you want to deploy. It will calculate all the direct and
indirect dependent components.

© Copyright SAP AG 2015 Internal/Confidential Page 10 of 12

Architecture Concept for NW AS JAVA Support Tool

5 Troubleshooting
5.1 Logging
The SAP NetWeaver JAVA Support Tool output log operation information into .\\PST.log file.

5.2 Maintenance
Maintenance will be owned by the NW JAVA Product Support team.

© Copyright SAP AG 2015 Internal/Confidential Page 11 of 12

Architecture Concept for NW AS JAVA Support Tool

6 Glossary

Term Definition
NW NetWeaver
SC Software Component
SWI Support Without Incidents
AGS Active Global Support
WSDL Web Service Definition Language. XML format for describing network
services

© Copyright SAP AG 2015 Internal/Confidential Page 12 of 12