#目录划分

# 服务器目录规划

# 安装目录

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

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

# HOME目录和DATA目录

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

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

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

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

# cd /
# mkdir data
# cd data
# mkdir yashan
# chown -R yashan:yashan /data/yashan

Note

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

# 运行日志目录

YashanDB的运行日志目录,包含数据库运行过程中产生的日志文件,该目录由yashan用户执行安装部署时输入的log-path参数根据一定规则生成并创建。

默认情况下,数据库的run.log、slow.log以及yasom和yasagent的日志都将保存在该目录,可通过修改相应的配置文件中的对应参数进行日志存放位置调整:

  • 集群名称.toml中group.node.config配置域下的RUN_LOG_FILE_PATH参数对应run.log的存放路径,SLOW_LOG_FILE_PATH参数对应slow.log的存放路径。

  • hosts.toml中host配置域下的log_path对应yasom和yasagent日志的存放路径。

Note

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

# 绑定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
    
  2. 输入如下内容后保存退出:

    #/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
    
  3. 执行脚本,生成配置文件:

    # 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/*
    
  2. 在两台服务器上分别执行以下命令,确认两台服务器上/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,需联系网络管理员处理。