场景三：手动安装 Proxy #

安装治理中心（可选） #

SphereEx-DBPlusEngine 的 Job 信息存储在治理中心中，CDC、迁移、重分片、洗数功能是需要启动 Job 执行并依赖治理中心，所以使用到这些内容是需要额外安装治理中心，治理中心推荐使用 Zookeeper。如不需要 CDC、迁移、重分片、洗数可以忽略治理中心的安装。

SphereEx-DBPlusEngine 支持 Zookeeper 3.6+ 的版本

安装 Zookeeper 请参考官方文档

ZooKeeper 部署注意事项 #

根据官网建议 ZooKeeper 标准配置为：2C、4G，最大堆内存设置 3G
建议独立使用 SSD 固态磁盘，减少 IO 竞争
合理配置日志清理策略，zoo_cfg 文件中如下配置：

autopurge.snapRetainCount=3 # ZooKeeper 自动清除功能将分别保留 dataDir 和 dataLogDir 中最新快照和相应的事务日志，并删除其余的。默认为 3。最小值为 3
autopurge.purgeInterval=1 # 触发清除日志任务的时间间隔（以小时为单位）。设置为正整数（1 及以上）以启用自动清除。默认为 0 （禁用）

部署 SphereEx-DBPlusEngine-Proxy #

部署多台 Proxy 时在不同的主机上执行步骤 1-6

创建普通用户 sphereex，对应程序目录授权

useradd sphereex
chown -R sphereex: /app
su - sphereex

获取安装包

# 请从商务处获得

安装 Proxy 所需 JAVA 环境

yum install -y java-1.8.0-openjdk.x86_64

配置 proxy

/app/sphereex-dbplusengine-proxy-x.x.x/conf/global.yaml

注：使用 CDC 时可以将 CDC 配置的注释打开

mode:
  type: Cluster
  repository:
    type: ZooKeeper
    props:
      namespace: governance_ds
      server-lists: [ZooKeeper ip]:[ZooKeeper port],[ZooKeeper ip]:[ZooKeeper port],[ZooKeeper ip]:[ZooKeeper port]
      retryIntervalMilliseconds: 500
      timeToLiveSeconds: 60
      maxRetries: 3
      operationTimeoutMilliseconds: 500

authority:
  users:
    - user: root@%
      password: root
    - user: sharding
      password: sharding
  privilege:
    type: ALL_PERMITTED

#cdc:
#  enabled: false
#  port: 33071

启动 proxy

/app/sphereex-dbplusengine-proxy-x.x.x/bin 不指定port默认使用3307端口

./start.sh [port]

停止 proxy

/app/sphereex-dbplusengine-proxy-x.x.x/bin

./stop.sh [port]

登陆 Proxy #

前提安装数据库的客户端，直接执行数据库的连接语句即可，以 MySQL 为例

mysql -uroot -proot -h 127.0.0.1 -P 3307

注册 License #

连接任意一台 Proxy 执行注册 License 的语句

注：License 文件请从商务处获得

register license 'XXXXXXXXXXXXX';
# XXXXXXXXXXXXX 为 License 文件中的文本

创建逻辑库 #

create database dbname

注册存储单元，加载单表 #

注：前提是数据库 server、DB、USER 已经存在

use dbname
REGISTER STORAGE UNIT ds_0 (
   HOST="127.0.0.1",
   PORT=3306,
   DB="db0",
   USER="root",
   PASSWORD="root");

load single table ds_0.*;

注册存储单元请参考加载单表请参考

至此就可以开始使用 Proxy 了