tencent cloud

文档反馈

Linux 安装手册

最后更新时间:2021-09-26 17:10:28

    操作场景

    本文档指导您在 Linux 系统环境下安装和使用 TcaplusDB PB 表。

    运行环境

    Linux 2.6、Suse 12 64 位。

    前提条件

    安装和使用 TcaplusDB PB 前需安装 Protobuf,TcaplusDB 当前支持 Protocol Buffers 2.6.1 版本以及3.5.0版本。
    Protobuf 是 Google 推出的一种混合语言数据标准,是一种轻便的结构化数据存储格式。TcaplusDB 系统支持使用 Protobuf 格式定义文件(.proto)定义数据表。使用 TcaplusDB PB API 之前,需要在开发服务器上安装 Protobuf,推荐使用源代码进行 Protobuf 安装,安装方法如下:

    1. 准备云服务器环境。
      首先需要准备安装了 CentOS6- x86_64 或 CentOS7-x86_64 版本操作系统的服务器。为了编译构建 Protobuf,需要安装以下软件,安装方法请自行查询:
      • autoconf
      • automake
      • libtool
      • curl (used to download gmock)
      • make
      • g++
      • unzip
    2. 下载 Protobuf 源码安装包,请参见 SDK 下载
    3. 请根据实际需求安装指定版本的 ProtoBuf,下文以 protobuf 2.6.1 版本为例。
    4. 执行以下命令,解压源码安装包,并进入源码根目录下。
      tar -xzvf protobuf-2.6.1.tar.gz
      cd ./protobuf-2.6.1
      
    5. Configure 并指定安装路径前缀,推荐安装到路径/usr/local/protobuf下。
      ./configure --prefix=/usr/local/protobuf
      
    6. 编译并安装。
      make
      make check
      make install
      
    7. 测试,使用 protoc 命令查看是否安装成功。如下所示,即表示安装成功。
      # protoc --version
      libprotoc 2.6.1
      

    操作步骤

    步骤1:安装 TcaplusDB SDK

    首先将 TcaplusDB SDK 下载至开发服务器,然后执行命令将文件安装至指定安装目录。

    tar –xzf <安装包路径> -C <安装目录>

    步骤2:校验

    安装完成后,根目录结构如下表所示:

    目录及文件 说明
    include/tcaplus_service/ TCAPLUS 服务化 API 头文件
    lib/libtcaplusserviceapi.a TCAPLUS 服务化 API 库文件
    include/tcaplus_service/protobuf/ Protobuf API 头文件
    lib/libtcaplusprotobufapi.a TCAPLUS Protobuf API 库文件
    examples/tcaplus/ProtoBuf TCAPLUS Protobuf API 应用示例

    步骤3:运行 example 访问 TcaplusDB

    GameSvr 游戏服务器中对应数据访问逻辑的开发,可以参考 example 中的各接口示例。

    1. 解压 TcaplusDB PB API 发布包。
      tar -xzvf TcaplusPbApi3.36.0.152096.x86_64_release_20170712.tar.gz
      
    2. 配置 TcaplusDB 系统连接信息。
      1. 在命令行输入如下代码进入目录:
        cd TcaplusPbApi3.36.0.152096.x86_64_release_20170712/release/x86_64/examples/tcaplus/C++_common_for_pb2
        
      2. 在命令行输入 vi common.h 修改 common.h 头文件,根据业务情况修改如下图片内容。
        DIR_URL_ARRAY:集群访问 IP 地址和端口号。
        DIR_URL_COUNT:固定值,保持为1即可。
        TABLE_NAME:需要访问的目标表。
        APP_ID:需要访问的接入 ID。
        ZONE_ID:填写需要访问的表格组 ID。
        SIGNATURE:集群访问密码。
    3. 修改环境配置文件。
      TcaplusPbApi3.36.0.152096.x86_64_release_20170712/release/x86_64/examples/tcaplus目录下有分别通过异步方式以及协程方式调用 API 的示例,此处以协程方式调用 Set 接口设置数据为例:
      在命令行输入如下代码进入目录:
      cd TcaplusPbApi3.18.0.152096.x86_64_release_20170712/release/x86_64/examples/tcaplus/C++_pb2_coroutine_simpletable/SingleOperation/set
      
      协程方式 Set 示例的所有代码都在该目录中。修改 envcfg.env 文件,将 PROTOBUF_HOME 环境变量设置为本机 protobuf 的安装路径(--prefix指定),并将 TCAPLUS_HOME 环境变量设置为 Tcaplus PB API 包下 release/x86_64 目录的绝对路径,如下图:
    4. 设置环境变量,在代码目录下执行如下命令:
      source envcfg.env
      bash conv.sh
      
    5. 编译二进制程序。
      执行make命令编译 example 二进制,编译成功生成 mytest 可执行文件。
    6. 执行二进制程序。
      在命令行输入./mytest ,执行二进制程序。执行结果将在命令行标准输出中显示,若遇到错误,请查看代码目录下的 tcaplus_pb.log 日志文件。
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持