游戏数据库 TcaplusDB Linux 安装手册

操作场景
本文档指导您在 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 系统连接信息。
2.1 在命令行输入如下代码进入目录：   
cd TcaplusPbApi3.36.0.152096.x86_64_release_20170712/release/x86_64/examples/tcaplus/C++_common_for_pb2
2.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 日志文件。

目录及文件	说明
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 应用示例

Linux 安装手册

本页目录：

操作场景

运行环境

前提条件

操作步骤

步骤1：安装 TcaplusDB SDK

步骤2：校验

步骤3：运行 example 访问 TcaplusDB