eRPC 项目安装与配置指南

eRPC 项目安装与配置指南

eRPC Efficient RPCs for datacenter networks 项目地址: https://gitcode.com/gh_mirrors/erp/eRPC

1. 项目基础介绍

eRPC 是一个为数据中心网络设计的高速、通用的 RPC（远程过程调用）库。该项目旨在提供低延迟和高性能的 RPC 调用，支持多种网络类型，包括以太网、InfiniBand 和 RoCE。eRPC 的主要编程语言是 C++，它利用了现代 C++ 的一些高级特性来实现高效的网络通信。

2. 项目使用的关键技术和框架

• DPDK（Data Plane Development Kit）：用于高性能网络应用的数据平面开发工具包，可以显著提高网络数据包处理速度。
• RDMA（Remote Direct Memory Access）：一种允许在计算机之间直接访问对方内存的技术，减少了数据复制和CPU的使用，提高了通信效率。
• UDP：用户数据报协议，用于在计算机之间传输数据包，是 eRPC 支持的网络协议之一。

3. 项目安装和配置的准备工作

在开始安装 eRPC 之前，请确保您的系统满足以下要求：

• 操作系统：建议使用 Linux 系统。
• 网络接口卡（NIC）：至少需要 10 GbE 或更快的网络接口卡，Mellanox 的以太网和 InfiniBand 卡效果最佳。
• 内核模块：确保安装了必要的内核模块，如 ib_uverbs 和 mlx4_ib。
• Hugepages：每个 NUMA 节点至少需要 1024 个 huge pages。
• SHM 限制：确保 SHM 限制设置为无限制。
• DPDK：需要安装 DPDK 和 rdma-core，本文以 DPDK 21.11 版本为例。

安装步骤

1. 安装依赖

   首先，安装编译 eRPC 所需的依赖项：

   sudo apt install make cmake g++ gcc libnuma-dev libgflags-dev numactl
   

2. 安装 rdma-core

   从源代码安装 rdma-core：

   git clone https://github.com/linux-rdma/rdma-core.git
   cd rdma-core
   cmake .
   sudo make install
   

3. 安装 DPDK

   下载 DPDK 的 tarball 文件并解压缩。编辑 config/common_base 文件，将 CONFIG_RTE_LIBRTE_MLX5_PMD 和 CONFIG_RTE_LIBRTE_MLX4_PMD 设置为 y。然后编译和安装 DPDK：

   export RTE_SDK=/path/to/dpdk
   git clone --depth 1 --branch 'v21.11' https://github.com/DPDK/dpdk.git "${RTE_SDK}"
   cd "${RTE_SDK}"
   meson build -Dexamples='' -Denable_kmods=false -Dtests=false -Ddisable_drivers='raw/*,crypto/*,baseband/*,dma/*'
   cd build/
   DESTDIR="${RTE_SDK}/build/install" ninja install
   

4. 创建 hugepages

   创建并挂载 hugepages：

   sudo bash -c "echo 2048 > /sys/devices/system/node/node0/hugepages/hugepages-2048kB/nr_hugepages"
   sudo mkdir /mnt/huge
   sudo mount -t hugetlbfs nodev /mnt/huge
   

5. 编译 eRPC

   克隆 eRPC 仓库并编译：

   git clone https://github.com/erpc-io/eRPC.git
   cd eRPC
   cmake . -DTRANSPORT=dpdk
   make
   

6. 运行测试

   运行测试以验证安装是否成功：

   sudo ctest
   

以上步骤为基本的 eRPC 安装过程。根据具体的使用场景，可能还需要进行额外的配置和优化。请确保在运行 eRPC 应用程序之前，所有的网络配置和权限设置都是正确的。

eRPC Efficient RPCs for datacenter networks 项目地址: https://gitcode.com/gh_mirrors/erp/eRPC