Rate This Document
Findability
Accuracy
Completeness
Readability

Introduction

Overview

The Kunpeng DevKit command line tool is a toolset that includes the System Migration, Porting Advisor, Affinity Analyzer, Compiler and Debugger, and System Diagnosis tools. This document describes how to obtain, install, and use the Kunpeng DevKit command line tool. The following table lists the supported functions:

Table 1 Functions supported by the Kunpeng DevKit command line tool

Tool

Description

System Migration

Collects information about installed software including software packages, middleware, and databases in an application system, and analyzes the dependency compatibility in the POM file of a Maven project.

Porting Advisor

Ports software from x86 servers running Linux to Kunpeng servers running Linux, with necessary software scan and analysis capabilities.

Affinity Analyzer

Checks software code on the Kunpeng 920 platform to improve code quality and memory access performance.

HPC Debugger

Debugs MPI and MPI+OpenMP applications in launch mode. It must be run using the mpirun command.

System Profiler

Collects and analyzes performance data in multiple scenarios, and provides tuning suggestions based on the tuning system.

Python/C Profiler

Samples Python programs and mixed programs of Python and C/C++ and analyzes call stacks.

Java Profiler

Analyzes and optimizes the performance of Java applications running on Kunpeng servers.

System Diagnosis

Analyzes abnormalities in applications, non-CPCA-compliant cryptographic algorithms in source files, and sensitive information in files.

Kunpeng AutoTuner

Automatically tunes application parameters to improve application performance metrics in different scenarios.

JVM Jitter Detector

Monitors the code cache and JIT compiler metrics of Java applications, and generates alarms when detecting any abnormal metrics that could cause performance jitter.

  • The System Migration and Porting Advisor tools are available on x86 and Kunpeng 920 servers.
  • The Affinity Analyzer, Python/C Profiler, System Profiler, Java Profiler, System Diagnosis, Kunpeng AutoTuner, JVM Jitter Detector, and HPC Debugger tools are available only on Kunpeng 920 servers.

System Migration

The System Migration tool collects information about installed software including software packages, middleware, and databases in an application system, and analyzes the dependency compatibility in the POM file of a Maven project.
Table 2 Function description

Function

Description

Application information collection for system migration

Collects ledger and component information about the software installed in an application system, such as software packages, middleware, and databases.

Maven project source code analysis

Executes the mvn command to invoke the Maven plugin, parses the dependency compatibility in the POM file, and generates an HTML report.

Porting Advisor

The Porting Advisor simplifies the application porting process and supports scanning, analysis, and porting of software from x86 Linux to Kunpeng Linux. This tool can automatically analyze applications and generate guide reports, greatly improving code porting efficiency.
Table 3 Function description

Function

Description

Source code porting

Analyzes the portability of software written in C/C++/ASM/Fortran/Go or an interpreted language.

Software porting assessment

Analyzes the SO library files in the software installation path in the x86 environment and checks whether these files are compatible with the Kunpeng platform.

Affinity Analyzer

The Affinity Analyzer checks software code to improve code quality and memory access performance.
Table 4 Function description

Function

Description

64-bit running mode check

Identifies the 32-bit applications to be ported to the 64-bit platform and provides modification suggestions. It supports GCC 4.8.5 to GCC 10.3.0.

Byte alignment check

Checks the byte alignment of structure variables in the source code.

BC file generation

A BC file is used for memory consistency check and vectorization check.

Memory consistency check

Checks for any memory consistency problem when the source code is ported to the Kunpeng platform and provides suggestions on inserting memory barriers.

Vectorization check

Checks vectorizable code snippets and provides modification suggestions.

Matricization check

Checks matricizable code snippets and provides modification suggestions.

Build affinity

Analyzes the content in Makefile and CMakeLists.txt that can be replaced with content in the Kunpeng library, and provides replacement suggestions and function repair.

Cache line alignment check

Checks the 128-byte alignment of structure variables in the C/C++ source code to improve memory access performance.

Data race check

Checks for any dynamic memory inconsistency problem when C/C++ source code is running on the Kunpeng platform (specifically Kunpeng 920), and provides the check result and also suggestions on inserting memory barriers.

Calculation precision analysis

Locates the precision differences of the Fortran, C, and C++ languages caused by x86 and Kunpeng instructions.

K-NET

Collects data during runtime, analyzes and displays function call sequence diagrams, and analyzes POSIX function compatibility.

HPC Debugger

The HPC Debugger debugs MPI and MPI+OpenMP applications in launch mode. It must be run using the mpirun command.

System Profiler

The System Profiler is a performance analysis tool for Kunpeng-powered servers. It collects performance data of processor hardware, operating system (OS), processes/threads, and functions, analyzes system performance metrics, locates system bottlenecks and hotspot functions, and provides tuning suggestions.
Table 5 Function description

Function

Description

Microarchitecture analysis

Obtains the running status of instructions on the CPU pipeline based on Arm performance monitor unit (PMU) events, helping quickly locate performance bottlenecks of the current application on the CPU. You can modify your application to make full use of hardware resources.

HPC application analysis

Collects PMU events of the system and the key metrics of OpenMP and MPI applications to help you accurately obtain the serial and parallel times of the parallel region and barrier-to-barrier, calibrated 2-layer microarchitecture metrics, instruction distribution, L3 usage, and memory bandwidth.

Memory access analysis

Accesses the PMU events of the cache and memory and analyzes the number of storage access times, hit rate, and bandwidth.

NUMA refined analysis

Obtains the refined DDR access, NUMA access bandwidth matrix, and processes' memory access information based on Arm SPE capabilities.

Roofline analysis

Helps pinpoint application bottlenecks on a given hardware platform and optimize the application accordingly.

Hotspot function analysis

Analyzes C/C++ program code, identifies performance bottlenecks, and provides details about the top hotspot functions and call stacks. The tool also displays the function call relationship in flame graphs and provides the tuning path.

Miss event analysis

Uses the Statistical Profiling Extension (SPE) capability to analyze miss events such as LLC Miss, TLB Miss, Remote Access, and Long Latency Load. You can modify your program to reduce the probability of miss events and improve the program processing performance.

Hotspot function analysis (Python/C)

Uses ptrace to sample Python programs and Python & C/C++ hybrid programs, analyzes call stacks, obtains top 20 hotspot functions, and draws flame graphs.

Python/C Profiler

Table 6 Function description

Function

Description

Hotspot function analysis

Uses ptrace to sample Python programs and Python & C/C++ hybrid programs, analyzes call stacks, obtains top 20 hotspot functions, and draws flame graphs.

Java Profiler

The Java Profiler analyzes and optimizes the performance of Java applications running on Kunpeng servers. The tool identifies hotspot functions, locates performance bottlenecks, and provides tuning suggestions.
Table 7 Function description

Function

Description

Hotspot analysis

Collects stack information about CPU, CYCLES, LOCK, CACHE_MISSES, and ALLOC events at certain points of time, collects statistics on hotspot methods in the current JVM, and displays the information in a flame graph and an inverted flame graph.

System Diagnosis

The System Diagnosis tool analyzes system running metrics of Kunpeng servers to identify abnormalities, such as memory leak and memory overwriting.
Table 8 Function description

Function

Description

Memory usage

Collects performance data about memory allocation and release, and checks whether any allocated memory space has not been released.

Memory overwriting

Analyzes memory overwriting problems of applications and provides memory overwriting and access information.

CPCA

The Classified Protection and Cryptography Assessment (CPCA) function works based on the System Diagnosis tool. It analyzes cryptographic algorithms that do not comply with CPCA specifications in source code and sensitive file information.
Table 9 Function description

Function

Description

Non-SM algorithm detection

Analyzes cryptographic algorithms that do not comply with CPCA specifications in source code and provides analysis reports.

Sensitive information scan

Scans for sensitive file information in specified directories based on the built-in sensitive information library and user-defined rules, and provides detection reports.

Kunpeng AutoTuner

The Kunpeng AutoTuner tool automatically tunes application parameters to improve application performance metrics in different scenarios.

Table 10 Function description

Function

Description

Generating a template file

Generates a parameter file based on the application and task parameters users set on the interactive user interface.

Enabling automatic tuning

Automatically tunes performance based on the given parameters and performance test result.

Using the tuning result

Uses the tuning result to perform subsequent operations such as performance data display and retest, and parameter value assignment and resetting.

JVM Jitter Detector

The JVM Jitter Detector monitors the code cache and JIT compiler metrics of Java applications, and generates alarms when detecting any abnormal metrics that could cause performance jitter.

Intended Audience

This document is intended for:

  • Kunpeng developers
  • Kunpeng software users
  • Independent software vendor (ISV) developers