#目录划分

# 服务器目录规划

# 安装目录

YashanDB采用集群多服务器并行安装模式,只需在一台服务器上创建安装目录,用于下载和解压软件包。

本安装手册中,安装目录规划在/home/yashan下,由yashan用户执行软件包下载时自行创建。

# HOME目录和DATA目录

所有YashanDB的实例节点都必须规划以下两个目录:

  • HOME目录:YashanDB的产品目录,包含YashanDB所提供的命令、数据库运行所需的库及各关键组件。该目录由yashan用户执行安装部署时输入的install-path参数根据一定规则生成并创建。

  • DATA目录:YashanDB的数据目录,包含数据库的各类系统数据文件、部分日志文件和配置文件,用户数据也缺省存储在该目录下。但对于共享集群,所有的数据文件和redo文件均需保存在共享存储上,DATA目录将只用于存储实例运行相关的配置文件、日志文件等数据。该目录由yashan用户执行安装部署时输入的--data-path参数根据一定规则生成并创建。

本安装手册中,HOME目录和DATA目录均规划在/data/yashan下,yashan用户需要对该目录拥有全部权限,可执行如下命令授权:

# cd /
# mkdir data
# cd data
# mkdir yashan
# chmod -R 777 /data/yashan

Note

DATA目录包括的部分日志文件具体见日志管理中日志分类章节描述。

# 运行日志目录

YashanDB的运行日志目录,包含数据库运行过程中产生的日志文件,该目录默认为HOME目录/yashandb/版本号/log。

Note

为避免运行日志跟数据文件IO相互影响,建议将数据库的运行日志与数据文件路径配置到不同的物理盘上。

  • 运行日志路径:由集群配置文件(集群名称.toml)中group.node.config配置域下的RUN_LOG_FILE_PATH参数决定。

  • 数据文件路径:由执行安装部署时输入的--data-path参数决定,安装完成后可直接修改集群配置文件中group.node配置域下的data_path参数。共享集群部署的数据文件路径默认配置在共享存储下,无法直接修改,只能通过修改共享存储的路径从而调整数据文件存储的路径。

# 绑定LUN(共享集群部署)

本步骤只适用于共享集群部署,单机/分布式部署请略过。

YashanDB要求共享存储上必须规划出下述三类磁盘:

  • 数据盘:一块或多块,根据业务实际情况规划,其中一块数据盘的路径将作为yasboot package ce gen命令的data选项参数。
  • 投票盘:一块,建议规划为1G及以上,该盘路径将作为yasboot package ce gen命令的vote选项参数。
  • YCR盘:一块,建议规划为1G及以上,该盘路径将作为yasboot package ce gen命令的YCR选项参数。

基于共享存储的品牌不同,操作方式相应不同,本安装手册不对共享存储的组网和存储划分操作进行描述,建议由公司网络管理员依据所购品牌提供的安装指导完成组网和存储划分。

本安装手册既定共享存储上已划分三个LUN并已通过多路径的方式挂载,多路径名称(YashanDB要求划分LUN时所指定路径长度不超过31B)如下:

  • /dev/mapper/storraid5:数据盘,按规划需绑定至/dev/yas/data路径。
  • /dev/mapper/storraid10:投票盘,按规划需绑定至/dev/yas/vote路径。
  • /dev/mapper/storraid15:YCR盘,按规划需绑定至/dev/yas/ycr路径。

以下将描述在所有服务器上进行LUN绑定的操作过程:

# 步骤1:生成配置文件

  1. 在root目录下创建名称为genDevRuleByUUID.sh的脚本文件:
# cd
# vi genDevRuleByUUID.sh
  1. 输入如下内容后保存退出:
#/bin/bash

curDir=$(cd "$(dirname "$0")";pwd)
rm -f $curDir/yashan-device-rule.rules
for i in storraid5 storraid10 storraid15;
do
str1="$i:`udevadm info --query=all --name=/dev/mapper/$i | grep DM_UUID`"
str2=${str1#*=}
echo "KERNEL==\"dm-*\",ENV{DM_UUID}==\"${str2}\",SYMLINK+=\"yas/${i}\",OWNER=\"yashan\",GROUP=\"YASDBA\",MODE=\"0666\"" ''  >> $curDir/yashan-device-rule.rules
done
  1. 执行脚本,生成配置文件:
# sh ./genDevRuleByUUID.sh

脚本执行成功后,会在当前路径生成名称为yashan-device-rule.rules的绑定配置文件,内容如下:

# cat yashan-device-rule.rules
KERNEL=="dm-*",ENV{DM_UUID}=="mpath-366c146e100955f46eaa458fc0000006b",SYMLINK+="yas/storraid5",OWNER="yashan",GROUP="YASDBA",MODE="0666" 
KERNEL=="dm-*",ENV{DM_UUID}=="mpath-366c146e100955f46eaa49e8c0000006d",SYMLINK+="yas/storraid10",OWNER="yashan",GROUP="YASDBA",MODE="0666" 
KERNEL=="dm-*",ENV{DM_UUID}=="mpath-366c146e100955f46eaa4c6040000006f",SYMLINK+="yas/storraid15",OWNER="yashan",GROUP="YASDBA",MODE="0666"

SYMLINK为绑定设备的别名,可修改为业务可理解的名称,例如修改为如下内容:

# vi yashan-device-rule.rules
KERNEL=="dm-*",ENV{DM_UUID}=="mpath-366c146e100955f46eaa458fc0000006b",SYMLINK+="yas/data",OWNER="yashan",GROUP="YASDBA",MODE="0666" 
KERNEL=="dm-*",ENV{DM_UUID}=="mpath-366c146e100955f46eaa49e8c0000006d",SYMLINK+="yas/vote",OWNER="yashan",GROUP="YASDBA",MODE="0666" 
KERNEL=="dm-*",ENV{DM_UUID}=="mpath-366c146e100955f46eaa4c6040000006f",SYMLINK+="yas/ycr",OWNER="yashan",GROUP="YASDBA",MODE="0666"

# 步骤2:部署配置文件

执行如下命令部署绑定配置文件:

# cp yashan-device-rule.rules /etc/udev/rules.d/yashan-device-rule.rules

# 步骤3:重启服务器

绑定配置文件的生效需要重启服务器:

# systemctl reboot

# 步骤4:检查绑定结果

  1. 执行如下命令,确认/dev/yas/data/dev/yas/vote/dev/yas/ycr已存在,且权限位为666。
# ls -l /dev/yas/*
  1. 在两台服务器上分别执行以下命令,确认两台服务器上/dev/yas/data/dev/yas/vote/dev/yas/ycr对应的WWID是否一致。
## 对比两台服务器上的输出结果是否对应一致
# /lib/udev/scsi_id --whitelisted  --device=/dev/yas/data
# /lib/udev/scsi_id --whitelisted  --device=/dev/yas/vote
# /lib/udev/scsi_id --whitelisted  --device=/dev/yas/ycr

若两台服务器上同一路经所对应的WWID不一致,说明其挂载的磁阵不是同一个LUN,需联系公司网络管理员处理。