YashanDB目录划分

本文内容来自YashanDB官网，原文内容请见 https://doc.yashandb.com/yashandb/23.3/zh/%E5%AE%89%E8%A3%85%...

安装目录

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用户需要对该目录拥有全部权限，可执行如下命令授权：

Copied!

Note：

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

运行日志目录

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

Note：

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

• 运行日志路径：由集群配置文件（集群名称.toml）中group.node.config配置域下的RUN\_LOG\_FILE\_PATH参数决定。
• 数据文件路径：由执行安装部署时输入的--data-path参数决定，安装完成后可直接修改集群配置文件中group.node配置域下的data\_path参数。共享集群部署的数据文件路径默认配置在共享存储下，无法直接修改，只能通过修改共享存储的路径从而调整数据文件存储的路径。

绑定LUN（共享集群部署）

---

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

实际部署环境可能与示例不同，请参考示例调整，请勿将以下配置直接用于生产环境。

YashanDB要求共享存储规划2类磁盘：

• 系统盘：用于集群管理，仅支持1、3或5块相同大小的磁盘，建议每块磁盘容量至少1G，此类磁盘的绝对路径将作为yasboot package ce gen命令的--system-data选项，以,分隔多个磁盘，例如--system-data /dev/yfs/sys0,/dev/yfs/sys1,/dev/yfs/sys2。
• 数据盘：用于保存集群业务数据，1块或多块相同大小的磁盘，请根据实际业务需求规划其数量和容量，此类磁盘的绝对路径将作为yasboot package ce gen命令的--data选项参数，以,分隔多个磁盘，例如--data /dev/yfs/data0,/dev/yfs/data1,/dev/yfs/data2。

所有系统盘和数据盘应被绑定至同一目录，该目录将作为yasboot package ce gen命令的--disk-found-path选项参数，本文采用默认值/dev/yfs作为示例。

本安装手册不对共享存储的组网和存储划分提供操作指引，请管理员根据共享存储厂商提供的安装指导操作。

本安装手册假定3块系统盘、1块数据盘，共享存储上已划分4个LUN并已通过多路径的方式挂载，规划如下：

• /dev/mapper/lun01-data0：数据盘，规划绑定至/dev/yfs/data0路径。
• /dev/mapper/lun03-sys0：系统盘，规划绑定至/dev/yfs/sys0路径。
• /dev/mapper/lun04-sys1：系统盘，规划绑定至/dev/yfs/sys1路径。
• /dev/mapper/lun05-sys2：系统盘，规划绑定至/dev/yfs/sys2路径。

绑定目录（/dev/yfs）与磁盘名称（data0、sys0等）均为示例值，请根据实际业务需求调整，但命名时需注意：

• 绑定后磁盘的绝对路径（例如/dev/yfs/sys0）长度不得超过31字节。
• 绑定目录和磁盘的绝对路径均将作为yasboot package ce gen命令的参数值，如有修改，请在执行yasboot package ce gen时使用实际参数。

请以root用户在集群所有服务器上执行下述LUN绑定操作：

步骤1：生成配置文件

1. 在root目录下创建名称为genDevRuleByUUID.sh的脚本：

   Copied!

2. 输入如下内容，并根据部署环境，修改DEVICES各设备路径，修改TARGETS指定各设备绑定名称，应与DEVICES参数一一对应，修改YFS_DISK_DIR为绑定目录，保存退出：

   
   
   
   DEVICES=("/dev/mapper/lun01-data0" "/dev/mapper/lun03-sys0" "/dev/mapper/lun04-sys1" "/dev/mapper/lun05-sys2")
   
   TARGETS=("data0"                   "sys0"                   "sys1"                   "sys2")
   
   YFS_DISK_DIR="/dev/yfs"
   
   
   USER="yashan"
   GROUP="yashan"
   UGROUP="$USER:$GROUP"
   
   if [ ${#TARGETS[@]} != ${#DEVICES[@]} ]
   then
       echo "DEVICES and TARGETS count does not match"
       exit 1
   fi
   
   if [ ${#TARGETS[@]} == 0 ]
   then
       echo "no targets found"
       exit 1
   fi
   
   curDir=$(cd "$(dirname "$0")";pwd)
   rm -f $curDir/yashan-device-rule.rules
   
   count=${#TARGETS[@]}
   
   for ((i = 0; i < $count; i ++))
   do
       device=${DEVICES[$i]}
       target_name=${TARGETS[$i]}
       target="${YFS_DISK_DIR}/${target_name}"
       
       str1="$device:`udevadm info --query=all --name=$device | grep DM_UUID`"
       str2=${str1#*=}
       echo "KERNEL==\"dm-*\",ENV{DM_UUID}==\"${str2}\",SYMLINK+=\"$target\",OWNER=\"$USER\",GROUP=\"$GROUP\",MODE=\"0666\",RUN+=\"/bin/sh -c 'chown -R yashan:yashan $target'\""  >> $curDir/yashan-device-rule.rules
   done
   

   Copied!

3. 执行脚本，生成配置文件：

   脚本执行成功后，会在当前路径生成名为yashan-device-rule.rules的绑定配置文件，内容如下，实际部署时内容可能有差异：

   
   KERNEL=="dm-*",ENV{DM_UUID}=="mpath-36d039ea000a2231f0000e7d9668d7b4a",SYMLINK+="/dev/yfs/data0",OWNER="yashan",GROUP="yashan",MODE="0666",RUN+="/bin/sh -c 'chown -R yashan:yashan /dev/yfs/data0'"
   KERNEL=="dm-*",ENV{DM_UUID}=="mpath-36d039ea000a2231f0000e7dd668d7b68",SYMLINK+="/dev/yfs/sys0",OWNER="yashan",GROUP="yashan",MODE="0666",RUN+="/bin/sh -c 'chown -R yashan:yashan /dev/yfs/sys0'"
   KERNEL=="dm-*",ENV{DM_UUID}=="mpath-36d039ea000a233b90000e358668d7caf",SYMLINK+="/dev/yfs/sys1",OWNER="yashan",GROUP="yashan",MODE="0666",RUN+="/bin/sh -c 'chown -R yashan:yashan /dev/yfs/sys1'"
   KERNEL=="dm-*",ENV{DM_UUID}=="mpath-36d039ea000a233b90000e35a668d7cbf",SYMLINK+="/dev/yfs/sys2",OWNER="yashan",GROUP="yashan",MODE="0666",RUN+="/bin/sh -c 'chown -R yashan:yashan /dev/yfs/sys2'"
   

   Copied!

   SYMLINK为绑定设备的别名，检查是否为预期绑定目标。

步骤2：部署配置文件

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

步骤3：重启服务器

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

步骤4：检查绑定结果

1. 执行如下命令，确认所有绑定已生效，用户和组均为yashan：

   
   lrwxrwxrwx 1 yashan yashan 7 Jul 11 14:44 data0 -> ../dm-5
   lrwxrwxrwx 1 yashan yashan 7 Jul 11 14:44 sys0 -> ../dm-7
   lrwxrwxrwx 1 yashan yashan 7 Jul 11 14:44 sys1 -> ../dm-4
   lrwxrwxrwx 1 yashan yashan 7 Jul 11 14:44 sys2 -> ../dm-6
   

   Copied!

   并检查它们指向设备的用户和组均为yashan，且权限为0666：

   
   brw-rw-rw- 1 yashan yashan 253, 4 Jul 11 14:44 /dev/dm-4
   
   
   

   Copied!

2. 在集群所有服务器上执行以下命令，确认各服务器上所有绑定的多路径WWID一致。

   Copied!

   若各服务器上同一路经所对应的WWID不一致，说明其挂载的磁阵不是同一个LUN，请联系网络管理员处理。