单机版部署指导

1. 注意事项

  1. 安装前请确认系统已参照系统配置 准备完成。

  2. 部署时推荐优先使用hostname进行IP配置，可避免后期修改主机ip导致数据库无法启动的问题。设置hostname需要在目标服务器上配置/etc/hosts，如本机ip是192.168.1.3，hostname是udbds-1，则可以使用以下命令设置服务器的 hostname，并使用hostname配置UDB-DS的cn_internal_address、dn_internal_address、dn_rpc_address。

    echo "192.168.1.3  udbds-1" >> /etc/hosts

  3. 部分参数首次启动后不能修改，请参考下方的参数配置章节进行设置。

  4. 请确保UDB-DS的安装路径中不含空格和中文，避免软件运行异常。

  5. 请注意，安装部署UDB-DS时需要保持使用同一个用户进行操作，您可以：

  • 使用 root 用户（推荐）：使用 root 用户可以避免权限等问题。

  • 使用固定的非 root 用户：

    • 使用同一用户操作：确保在启动、停止等操作均保持使用同一用户，不要切换用户。

    • 避免使用 sudo：尽量避免使用 sudo 命令，因为它会以 root 用户权限执行命令，可能会引起权限混淆或安全问题。

2. 安装步骤

2.1 解压安装包并进入安装目录

tar -xzvf udbds-{version}-all-bin.tar.gz
cd  udbds-{version}-all-bin

2.2 参数配置

环境脚本配置

  • ./conf/confignode-env.sh配置

配置项 说明 默认值 推荐值 备注
MEMORY_SIZE UDB-DS ConfigNode节点可以使用的内存总量 空 可按需填写，填写后系统会根据填写的数值来分配内存 修改后保存即可，无需执行；重启服务后生效

  • ./conf/datanode-env.sh配置

配置项 说明 默认值 推荐值 备注
MEMORY_SIZE UDB-DS DataNode节点可以使用的内存总量 空 可按需填写，填写后系统会根据填写的数值来分配内存 修改后保存即可，无需执行；重启服务后生效

系统通用配置

打开通用配置文件（./conf/udbds-system.properties 文件），设置以下参数：

配置项 说明 默认值 推荐值 备注
cluster_name 集群名称 defaultCluster 可根据需要设置集群名称，如无特殊需要保持默认即可 首次启动后不可修改
schema_replication_factor 元数据副本数，单机版此处设置为 1 1 1 默认1，首次启动后不可修改
data_replication_factor 数据副本数，单机版此处设置为 1 1 1 默认1，首次启动后不可修改

ConfigNode 配置

打开ConfigNode配置文件（./conf/udbds-system.properties文件），设置以下参数：

配置项 说明 默认 推荐值 备注
cn_internal_address ConfigNode在集群内部通讯使用的地址 127.0.0.1 所在服务器的IPV4地址或hostname，推荐使用hostname 首次启动后不能修改
cn_internal_port ConfigNode在集群内部通讯使用的端口 17710 17710 首次启动后不能修改
cn_consensus_port ConfigNode副本组共识协议通信使用的端口 17720 17720 首次启动后不能修改
cn_seed_config_node 节点注册加入集群时连接的ConfigNode 的地址，cn_internal_address:cn_internal_port 127.0.0.1:17710 cn_internal_address:cn_internal_port 首次启动后不能修改

DataNode 配置

打开DataNode配置文件 ./conf/udbds-system.properties，设置以下参数：

配置项 说明 默认 推荐值 备注
dn_rpc_address 客户端 RPC 服务的地址 0.0.0.0 所在服务器的IPV4地址或hostname，推荐使用hostname 重启服务生效
dn_rpc_port 客户端 RPC 服务的端口 7777 7777 重启服务生效
dn_internal_address DataNode在集群内部通讯使用的地址 127.0.0.1 所在服务器的IPV4地址或hostname，推荐使用hostname 首次启动后不能修改
dn_internal_port DataNode在集群内部通信使用的端口 17730 17730 首次启动后不能修改
dn_mpp_data_exchange_port DataNode用于接收数据流使用的端口 17740 17740 首次启动后不能修改
dn_data_region_consensus_port DataNode用于数据副本共识协议通信使用的端口 17750 17750 首次启动后不能修改
dn_schema_region_consensus_port DataNode用于元数据副本共识协议通信使用的端口 17760 17760 首次启动后不能修改
dn_seed_config_node 节点注册加入集群时连接的ConfigNode地址,即cn_internal_address:cn_internal_port 127.0.0.1:17710 cn_internal_address:cn_internal_port 首次启动后不能修改

❗️注意：VSCode Remote等编辑器无自动保存配置功能，请确保修改的文件被持久化保存，否则配置项无法生效

2.3 启动ConfigNode 节点

进入UDB-DS的sbin目录下，启动confignode

./start-confignode.sh    -d      #“-d”参数将在后台进行启动

如果启动失败，请参考常见问题 。

2.4 启动DataNode 节点

进入udbds的sbin目录下，启动datanode：

cd sbin
./start-datanode.sh   -d   #-d参数将在后台进行启动

2.5 验证部署

可直接执行 ./sbin 目录下的 Cli 启动脚本：

./start-cli.sh  -h  ip(本机ip或域名)  -p  端口号(7777)

成功启动后，出现如下界面显示UDB-DS安装成功。

../_images/UDB-DS_login.png

出现安装成功界面后，使用show cluster命令查看服务运行状态

当看到status都是running表示服务启动成功

../_images/ShowCluster.png

3. 常见问题

  1. Confignode节点启动失败

    步骤 1: 请查看启动日志，检查是否修改了某些首次启动后不可改的参数。

    步骤 2: 请查看启动日志，检查是否出现其他异常。日志中若存在异常现象，请联系九有技术支持人员咨询解决方案。

    步骤 3: 如果是首次部署或者数据可删除，也可按下述步骤清理环境，重新部署后，再次启动。

    步骤 4: 清理环境：

    a. 结束所有 ConfigNode 和 DataNode 进程。

        # 1. 停止 ConfigNode 和 DataNode 服务
    sbin/stop-standalone.sh

    # 2. 检查是否还有进程残留
    jps
    # 或者
    ps -ef|grep udbds

    # 3. 如果有进程残留，则手动kill
    kill -9 <pid>
    # 如果确定机器上仅有1个udbds，可以使用下面命令清理残留进程
    ps -ef|grep udbds|grep -v grep|tr -s '  ' ' ' |cut -d ' ' -f2|xargs kill -9

    b. 删除 data 和 logs 目录。

    说明：删除 data 目录是必要的，删除 logs 目录是为了纯净日志，非必需。

        cd /data/udbds
    rm -rf data logs