Note3：解题思路：https://tianchi.aliyun.com/forum/postDetail?spm=5176.12586969.1002.6.23f43542Ux6F5e&postId=401000
- 请详细阅读下文的参赛流程；
- RDMA 注册内存时申请的内存(较大的话)4K对齐；
- 避免过多过小的内存注册，以避免额外元信息开销；
- 避免超大的内存注册，避免注册失败或RDMA访问变慢
- 模拟环境跑demo，server在创建pd的时候默认用第一块网卡，而选手在添加模拟网卡时，可能会遇到一些网卡成功添加但不能使用的情况，这样在跑demo的时候，即使设置了对应网卡的addr和port，也会因为pd没对应上失败； 解决方法是用rdma link delete NAME命令，删掉无法使用的网卡；
- 模拟环境单次注册内存，到64M就会失败，erdma单次可以注册2G；
- 自己写server/client测试的时候，如果复用同一个工程，注意在server/client编译时候得加link对应库文件；
参见相关网页
实现LocalEngine类（位于local节点），重载Start, Read, Write, Stop函数来实现引擎主节点的启动、读取、写入、停止功能。
实现RemoteEngine类（位于remote节点），重载Start, Stop函数来实现引擎远端节点的启动、停止功能。
我们会先在remote节点启动RemoteEngine对象，RemoteEngine在有通讯需要时应当作为server角色，LocalEngine作为client角色；Engine的启动参数如下：
/**
* @param {addr} the address of RemoteEngine to connect
* @param {port} the port of RemoteEngine to connect
* @return {bool} true for success
*/
bool LocalEngine::start(const std::string addr, const std::string port);
/**
* @param {addr} empty string
* @param {port} the port the server listened
* @return {bool} true for success
*/
bool RemoteEngine::start(const std::string addr, const std::string port)请完全实现类中定义的接口，其中KV读写接口需要保证并发安全。
编译方式： mkdir build && cd build && cmake .. && make && make install
生成后install文件需要在'git项目/build/polarkv'目录下：
静态库文件install在'git项目/build/polarkv/lib'，命名为libpolarkv.a；
头文件路径install在'git项目/build/polarkv/include'（参考CMakeLists.txt）, 评测程序只会引用kv_engine.h，选手自包含所需头文件。
评测程序调用方式： a. 在节点B生成remote端服务程序（期间KV库调用为生成RemoteEngine对象的并调用其Start接口）
b. 在节点A生成local端服务程序（期间KV库调用为生成LocalEngine节点对象的并调用其Start接口）
c. 在节点A依赖所规定的读写接口，进行程序正确性验证，通过后进行性能验证
d. 关闭并销毁local端服务程序、remote端服务程序（调用相应对象的Stop接口并销毁对象）
e. 完成验证后生成选手成绩
调用样例： a. remote节点
int main(int argc, char *argv[]) {
const std::string rdma_addr(argv[1]);
const std::string rdma_port(argv[2]);
RemoteEngine *kv_imp = new RemoteEngine();
assert(kv_imp);
kv_imp->start(rdma_addr, rdma_port);
do {
// sleep
} while (kv_imp->alive());
kv_imp->stop();
delete kv_imp;
return 0;
}a. local节点
int main(int argc, char *argv[]) {
const std::string rdma_addr(argv[1]);
const std::string rdma_port(argv[2]);
LocalEngine *kv_imp = new LocalEngine();
assert(kv_imp);
kv_imp->start(rdma_addr, rdma_port);
do {
// task
} while (kv_imp->alive());
kv_imp->stop();
delete kv_imp;
return 0;
}每次评测结束后，评测程序会将性能评测的结果生成的信息（流程信息、选手日志）上传到OSS供参赛者查看。 选手所有日志信息请使用标准输出，评测程序会将标准输出重定向到日志文件并放到OSS上供参赛者查看，仅保留最近一次运行日志。
评测程序对整体日志大小有所限制（10MB），过大的日志文件将失效。
- 注册阿里云账号登陆阿里天池，找到"[第四届全球数据库大赛赛道1：云原生共享内存数据库性能优化]"，并报名参加
- 登陆code.aliyun.com并完成账号注册，如果阿里云账号对应已有code平台相应账号则会直接登陆，请勿链接到新版（codeup）
- fork或者拷贝本仓库的代码到自己的仓库，重写Engine类中相关接口的实现。（本仓库的分支demo_kv有样例代码，可供参考）
- 为了允许评测程序拉取选手代码，选手需要在项目的成员配置处将官方账号：tianchi_polardbm_2022添加到这个项目，角色为Reporter
- 在天池提交成绩的入口，提交自己仓库的git地址（评测拉取的默认分支为master）
- 等待评测结果以及排名更新
阿里云线上ECS机器，基于eRDMA技术；
Local节点限制为16 Core、8 GB内存，Remote节点限制为4 Core、32 GB内存；
操作系统: Alibaba Cloud Linux 2.1903 LTS 64位
gcc version 8.3.1 20190311 (Red Hat 8.3.1-3) (GCC)
评测程序分为2个阶段：
-
正确性评测： 验证KV数据读写正确性和完整性
-
性能评测： 2.1 写入压测； 2.2 读取压测； 2.3 读写混合压测；
在正确性验证通过的情况下，对性能评测整体计时，根据规模压测总用时从低到高进行排名（用时越短排名越靠前）
cmake_minimum_required(VERSION 2.8)
project(TCTEST)
set(CMAKE_BUILD_TYPE "Release")
set(RDMA_LIB "-lrdmacm -libverbs -libumad -lpci -lefa")
set(CMAKE_CXX_FLAGS "-std=c++17 ${CMAKE_CXX_FLAGS}")
set(CMAKE_CXX_FLAGS "-pthread -ldl -lrt ${RDMA_LIB} -${CMAKE_CXX_FLAGS}")
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -O3 -fopenmp")
set(CMAKE_INSTALL_PREFIX ${CMAKE_BINARY_DIR}/xxxxx)
MESSAGE("Install prefix is: ${CMAKE_INSTALL_PREFIX}")
add_subdirectory(include)
add_subdirectory(lib)
include_directories(include)
include_directories(${PROJECT_SOURCE_DIR}/lib)
link_directories(${PROJECT_SOURCE_DIR}/lib)
add_executable(local
local.cc)
target_link_libraries(dblocal polarkv)
install(TARGETS dblocal
LIBRARY DESTINATION lib
ARCHIVE DESTINATION lib
RUNTIME DESTINATION bin
PUBLIC_HEADER DESTINATION include)
add_executable(remote
remote.cc)
target_link_libraries(dbremote polarkv)
install(TARGETS dbremote
LIBRARY DESTINATION lib
ARCHIVE DESTINATION lib
RUNTIME DESTINATION bin
PUBLIC_HEADER DESTINATION include)