我要评分
获取效率
正确性
完整性
易理解

Installing and Uninstalling the GPC SDK

  • The Development Assistant provides SDKs for Kunpeng general-purpose computing. You can create general-purpose computing application projects to facilitate development of basic applications, including acceleration library, hardware acceleration, and homogeneous acceleration framework (HAF) applications. An application project contains the source code of the selected libraries, rich demo files, and complete guidelines. It can also be compiled and executed in a few clicks using the Compiler and Debugger. In addition, acceleration library SDKs can be deployed on the Kunpeng development board.
  • The Kunpeng general-purpose computing SDKs provide libraries that are optimized based on Arm instructions and developed based on the Kunpeng Accelerator Engine (KAE). The libraries include the system library, compression, encryption/decryption, and acceleration libraries. They provide high-performance acceleration capabilities for application scenarios such as big data encryption and decryption, as well as software-defined storage compression.
  • The GPC SDK contains kunpeng-gpc and kunpeng-gpc-devel. kunpeng-gpc is used to run Kunpeng general-purpose computing applications, and kunpeng-gpc-devel used to develop Kunpeng general-purpose applications. Therefore, to run a Kunpeng general-purpose application, you only need to install kunpeng-gpc. To develop a Kunpeng general-purpose application, you need to install kunpeng-gpc and kunpeng-gpc-devel.

Prerequisites

  • The server must support and have the KAE license imported.
  • The OpenSSL version in the OS must be 1.1.1a or later.
  • The homogeneous acceleration framework supports only JDK 1.8.
  • The operating environment must be on a physical machine.
  • The OS must be CentOS 7.6 Arm, openEuler 20.03 LTS Arm, openEuler 20.03 LTS SP1 Arm, or Ubuntu 18.04.1 LTS Arm.

Installation Directory Structure

Table 1 Structure of the kunpeng-gpc installation directory

File Type

Installation Path

Description

KO file

/lib/modules/`uname -r`/extra/hisi_hpre.ko

/lib/modules/`uname -r`/extra/hisi_qm.ko

/lib/modules/`uname -r`/extra/hisi_rde.ko

/lib/modules/`uname -r`/extra/hisi_sec2.ko

/lib/modules/`uname -r`/extra/hisi_zip.ko

/lib/modules/`uname -r`/extra/uacce.ko

Installation paths of KO files.

Binary file

/usr/local/lib/engines-1.1/

/usr/local/lib/

/usr/local/bin/gzip (binary gzip)

Installation paths of binary files.

Software package

/usr/local/kunpeng-gpc

/usr/local/kunpeng-gpc/haf/

BoostKit-haf_1.3.0.zip

/usr/local/kunpeng-gpc/haf/BoostKit-haf_1.3.0.SPC2.zip

/usr/local/kunpeng-gpc/haf/BoostKit-haf_1.3.0.SPC6.zip

/usr/local/kunpeng-gpc/KAEzip-1.3.12/

Installation paths of the software packages (including the driver), HAF service package and JAR package.

Script file

export_LD_LIBRARY_PATH.sh

Installation path of the script file.

For openEuler 20.03 LTS, openEuler 20.03 LTS SP1, and CentOS 7.6, due to dependency restrictions, the KAEzip software package released in RPM format is a source package, and after installation KAEzip is stored in /usr/local/kunpeng-gpc/KAEzip-1.3.12. The KAEzip software package released in DEB format contains the compiled SO library.

Table 2 Structure of the kunpeng-gpc-devel installation directory

File Type

Installation Path

Description

Header file

/usr/local/include/kaezip/

/usr/local/include/warpdrive/

/usr/local/include/hyperscan/

/usr/local/include/snappy/

/usr/local/include/zstd/

Installation paths of header files.

Software package

/usr/local/kunpeng-gpc-devel

Installation path of the software package (including the demo, packaging tool, and SDK source code).

Installing the GPC SDK

  • Installing the SDK (CentOS 7.6, openEuler 20.03 LTS, or openEuler 20.03 LTS SP1)
    1. Obtain the GPC SDK installation packages.
    2. Decompress the installation packages.
      1
      2
      tar -zxvf kunpeng-gpc-xxx.aarch64.tar.gz
      tar -zxvf kunpeng-gpc-devel-xxx.aarch64.tar.gz
      
    3. Go to the decompressed directories and install the SDK packages.

      kunpeng-gpc:

      1
      rpm -ivh kunpeng-gpc-xxx.aarch64.rpm
      

      kunpeng-gpc-devel:

      1
      rpm -ivh kunpeng-gpc-devel-xxx.aarch64.rpm
      
  • Installing the SDK (Ubuntu 18.04.1 LTS)
    1. Obtain the GPC SDK installation package from the Kunpeng mirror.
    2. Decompress the installation packages.
      1
      2
      tar -zxvf kunpeng-gpc_xxx_arm64.tar.gz
      tar -zxvf kunpeng-gpc-devel_xxx_arm64.tar.gz
      
    3. Go to the decompressed directories and install the SDK packages.

      kunpeng-gpc:

      1
      dpkg -i kunpeng-gpc_xxx_arm64.deb
      
      kunpeng-gpc-devel:
      1
      dpkg -i kunpeng-gpc-devel_xxx_arm64.deb
      
  • xxx indicates the version number.
  • Obtain the latest TAR.GZ installation packages from the URLs given above, decompress the packages, and install the software.
  • The kunpeng-gpc-devel software package depends on the kunpeng-gpc software package. Therefore, install kunpeng-gpc before installing kunpeng-gpc-devel.
  • Ensure that kunpeng-gpc and kunpeng-gpc-devel software packages are of the same version.

Uninstalling the GPC SDK

  • Uninstalling the SDK (CentOS 7.6, openEuler 20.03 LTS, or openEuler 20.03 LTS SP1)

    kunpeng-gpc-devel:

    1
    rpm -e kunpeng-gpc-devel
    

    kunpeng-gpc:

    1
    rpm -e kunpeng-gpc
    
  • Uninstalling the SDK (Ubuntu 18.04.1 LTS)

    kunpeng-gpc-devel:

    1
    dpkg --purge kunpeng-gpc-devel
    
    kunpeng-gpc:
    1
    dpkg --purge kunpeng-gpc
    

The kunpeng-gpc-devel software package depends on the kunpeng-gpc software package. Therefore, uninstall kunpeng-gpc-devel before uninstalling kunpeng-gpc.

Demo Usage

After the installation is successful, refer to the README files of the corresponding demos in the /usr/local/kunpeng-gpc-devel/example directory for details.