SAP Knowledge Base Article

1813020 - How to generate a runtime dump on SAP HANA

Component: HAN-DB (SAP HANA > SAP HANA Database), Version: 16, Released On: 31.08.2024

Symptom
SAP Support asks you to generate runtime dump(s) for example during performance issues.

Environment
SAP HANA, platform edition 1.0
SAP HANA, platform edition 2.0

Resolution
There are a number of ways of recording runtime dumps:
1) From OS level using fullSystemInfoDump.py
1) Login as <sid>adm and run commands below:

..> cdpy

../python_support> python fullSystemInfoDump.py --rtedump --tenant=<tenant> --sets=3 --interval=

1 --services=indexserver

The command above creates a set of 3 runtime dumps, for the indexserver, 1 minute apart for the specified tenant for all
hosts (hosts can be specified with --hosts=<hosts>)
To see a full list of options:

../python_support> python fullSystemInfoDump.py --help

2) Wait for the collection to finish.

The latest runtimedump collection can then be downloaded from:

/usr/sap/<SID>/SYS/global/sapcontrol/snapshots> ls -latr | grep 'fullsystem*'

2) From the OS Level using hdbcons

1) Log into the linux HANA host presenting the issue as sidadm user;
2) Run command 'hdbcons';
3) On the hdbcons console run command below:
> runtimedump dump

This will create a runtimedump for the host you logged in. The generated file will be under traces directory with naming
like 'indexserver....rtedump.trc'.
4) Attach generated trace file to the OSS Message
3) From HANA Studio - SQL Editor
1) Log into HANA with a user with privileges enough to run procedure SYS.MANAGEMENT_CONSOLE_PROC;
2) Execute procedure SYS.MANAGEMENT_CONSOLE_PROC as a prepared statement;
3) Fill in parameter 1 with 'runtimedump dump' and parameter 2 with '<hostname>:<indexserver port>' (whithout
quotes) and execute the statement;
4) Download the generated rtedump file and attach it to the message.
The screenshots below depicts an example of how to record that dump in Studio:
4) From HANA Studio - Trace Collection
SAP HANA Studio SP8 adds the possibillity of recording one or multiple samples of runtimedump based on a certain time
frequency.
For instance we can record a set of 5 runtimedumps, 1 every minute for every host or for a particular host only. Here are the
steps:
1) Go to Administration -> Diagnosis Files;
2) Select "Diagnosis Information -> Collect...";
3) Set the option 'Create and collect one or multiple sets of runtime environment (RTE) dump file(s)';
4) Set the hosts, amount of samples (sets) and frenquency on which the runtime dumps will be recorded;
5) Finish.
5) Using SQL Commands (available starting with HANA 2.0 SPS04):
ALTER SYSTEM CREATE RUNTIMEDUMP AT '<host>:<port>';
-- OR
CALL FULL_SYSTEM_INFO_DUMP_CREATE('--tenant=<SBID> --rtedump --sets=1 --services=indexserver --interval=1')
6) Known issues related to rtedump creation
2040144 - SAP HANA DB: Collecting Diagnosis Information from the SAP HANA Studio can cause TLB shootdowns
When using ALTER SYSTEM .. command please note that runtime dump can only be generated for processes that
belong to the same service.
e.g. connected to tenant database will only allow to create runtimedump for indexserver and xengine.
Trying to generate runtimedump for nameserver will generate an error :

Could not execute 'ALTER SYSTEM CREATE RUNTIMEDUMP AT LOCATION 'localhost:30001' INTO FILE
'nameserver_dump_1.trc'' in 2 ms 325 µs .
SAP DBTech JDBC: [7]: feature not supported: Can only create waitgraph of own service.

To generate runtimedump for nameserver please connect to SYSTEMDB.

You can also generate a runtmedump for the nameserver via hdbcons tool
hdbcons -p <nameserver pid> "runtimedump dump -i"

Replace <nameserver pid> by the respective process id of the nameserver process. You can find the id, e.g., with the
output of the command ./HDB info

See Also
2400007 - FAQ: SAP HANA Runtime Dumps
2462851 - How to generate a runtime dump - Guided Answers
2222218 FAQ: SAP HANA Database Server Management Console (hdbcons)
For HANA Cloud, see 3425554 - Collecting full system dump and RTE dumps for SAP HANA Cloud

Keywords
runtimedump; CPU; hdbcons; SYS.MANAGEMENT_CONSOLE_PROC; runtime environment, RTE, high Memory

Attributes
Key Value

Other Components SAP HANA > SAP HANA Database > SAP HANA Database Performance (HAN-DB-PERF)
 Products
Products

SAP HANA, platform edition all versions

This document refers to

SAP Component Title
Note/KBA

2396001

2040144 HAN-DB SAP HANA DB: Collecting Diagnosis Information from the SAP HANA Studio can cause TLB
shootdowns

This document is referenced by

SAP Component Title
Note/KBA

3302520 Performance processing LOG-backups via backint

3219414 HAN-STD- Failed to evaluate: WithExpression

ADM-DBA

3272558 HAN-DB-PERF How to check the engine of a statement on SAP HANA

3108574 HAN-DB-ENG ABAP work processes occupied by "Sequential Read of DB" on a HANA Database

2784291 HAN-DB How to generate runtime dumps for a specific HANA service from command line

2400007 HAN-DB-PERF FAQ: SAP HANA Runtime Dumps

2000000 HAN-DB-PERF FAQ: SAP HANA Performance Optimization

2399979 HAN-DB-PERF How-To: Configuring automatic SAP HANA Data Collection with SAP HANASitter

1999020 HAN-DB How-To: SAP HANA Troubleshooting when Database is no longer accessible

2313619 HAN-DB-MON How-To: Generating and Evaluating SAP HANA Call Stacks

2222218 HAN-DB FAQ: SAP HANA Database Server Management Console (hdbcons)

2100009 HAN-DB-ENG FAQ: SAP HANA Savepoints

2092196 HAN-DB-ENG How-To: Terminating Sessions in SAP HANA

2100040 HAN-DB-PERF FAQ: SAP HANA CPU

2114710 HAN-DB-MON FAQ: SAP HANA Threads and Thread Samples

1999998 HAN-DB-PERF FAQ: SAP HANA Lock Analysis

2119087 HAN-DB How-To: Configuring SAP HANA Traces

2095794 HAN-DB-HA Nameserver startup hangs due to socket wait

2214569 HAN-DB Poor DTP Performance Caused by Reaching max Count of NO LOGGING Tables

2880502 HAN-DB Alter System Create Runtimedump/Waitgraph File Does Not Work Without Specifying Target
Filename

2743294 HAN-DB System not Responsive due to High Memory Consumption Causing Deadlocks in Handling NO
LOGGING RETENTION Tables

2637781 HAN-DB SQL Query Fails With "Data receive failed [Connection reset]", Indexserver Reports Error "close
channel while sending reply message"

2387064 HAN-DB Long Running UPDATE/UPSERT Statements Especially in Data Aging

2373312 HAN-DB Upsert on Partitioned Columnstore Table is Slow With Many Threads in
TrexStore::UdivListContainerMVCC::checkValidEqualSSN

2340583 HAN-DB Scale-Out System is Hanging With Many Threads in

Synchronization::ReadWriteLock::timedWaitLockExclusive and High CPU Consumption on Worker
Nodes

1758890 HAN-DB SAP HANA: Information needed by Technical/Development Support

1992452 HAN-DB Startup of database hangs with threads in _MergeSortPartitionNode

1786918 HAN-DB Required information to investigate high memory consumption