Installing and Uninstalling the GPC SDK

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 and distributed storage and 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 and Uninstalling the GPC SDK

SDK installation and uninstallation (CentOS 7.6)
1. Obtain the GPC SDK installation package from the Kunpeng mirror site.
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 RPM packages.
  kunpeng-gpc:
  1
  rpm -ivh kunpeng-gpc-xxx.aarch64.rpm
  kunpeng-gpc-devel:
  1
  rpm -ivh kunpeng-gpc-devel-xxx.aarch64.rpm
4. Uninstall the RPM packages.
  kunpeng-gpc-devel:
  1
  rpm -e kunpeng-gpc-devel
  kunpeng-gpc:
  1
  rpm -e kunpeng-gpc
SDK installation and uninstallation (openEuler 20.03 LTS)
1. Obtain the GPC SDK installation package from the Kunpeng mirror site.
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 RPM packages.
  kunpeng-gpc:
  1
  rpm -ivh kunpeng-gpc-xxx.aarch64.rpm
  kunpeng-gpc-devel:
  1
  rpm -ivh kunpeng-gpc-devel-xxx.aarch64.rpm
4. Uninstall the RPM packages.
  kunpeng-gpc-devel:
  1
  rpm -e kunpeng-gpc-devel
  kunpeng-gpc:
  1
  rpm -e kunpeng-gpc
SDK installation and uninstallation (openEuler 20.03 LTS SP1)
1. Obtain the GPC SDK installation package from the Kunpeng mirror site.
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. Install the RPM packages.
  kunpeng-gpc:
  1
  rpm -ivh kunpeng-gpc-xxx.aarch64.rpm
  kunpeng-gpc-devel:
  1
  rpm -ivh kunpeng-gpc-devel-xxx.aarch64.rpm
4. Uninstall the RPM packages.
  kunpeng-gpc-devel:
  1
  rpm -e kunpeng-gpc-devel
  kunpeng-gpc:
  1
  rpm -e kunpeng-gpc
SDK installation and uninstallation (Ubuntu 18.04.1 LTS)
1. Obtain the GPC SDK installation package from the Kunpeng mirror site.
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 DEB packages.
  kunpeng-gpc:
  1
  dpkg -i kunpeng-gpc_xxx_arm64.deb
  kunpeng-gpc-devel:
  1
  dpkg -i kunpeng-gpc-devel_xxx_arm64.deb
4. Uninstall the DEB packages.
  kunpeng-gpc-devel:
  1
  dpkg --purge kunpeng-gpc-devel
  kunpeng-gpc:
  1
  dpkg --purge kunpeng-gpc

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 and kunpeng-gpc software packages are dependent on each other. You must install the kunpeng-gpc software package before installing the kunpeng-gpc-devel software package. Before uninstalling the kunpeng-gpc software package, ensure that the kunpeng-gpc-devel software package has been uninstalled.
Ensure that kunpeng-gpc and kunpeng-gpc-devel software packages are of the same version.

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.

Parent topic: General-purpose Computing Applications