本文内容来自YashanDB官网，原文内容请见 https://doc.yashandb.com/yashandb/23.3/zh/%E5%AE%89%E8%A3%85%E5%92%8C%E5%8D%87%E7%BA%A7/%E5%AE%89%E8%A3%85%E9%83%A8%E7%BD%B2/%E5%AE%89%E8%A3%85%E5%89%8D%E5%87%86%E5%A4%87/%E7%9B%AE%E5%BD%95%E5%88%92%E5%88%86.html
# 安装目录
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：生成配置文件
在root目录下创建名称为
genDevRuleByUUID.sh的脚本：Copied!
输入如下内容，并根据部署环境，修改
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!
执行脚本，生成配置文件：
脚本执行成功后，会在当前路径生成名为
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：检查绑定结果
执行如下命令，确认所有绑定已生效，用户和组均为
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-6Copied!
并检查它们指向设备的用户和组均为
yashan，且权限为0666：```
brw-rw-rw- 1 yashan yashan 253, 4 Jul 11 14:44 /dev/dm-4
```
Copied!
在集群所有服务器上执行以下命令，确认各服务器上所有绑定的多路径WWID一致。
Copied!
若各服务器上同一路经所对应的WWID不一致，说明其挂载的磁阵不是同一个LUN，请联系网络管理员处理。
