#分布式集群部署
请以安装用户（以yashan为例）登录到已下载软件包的服务器（本文以172.16.1.2为例），并进入软件包所在的安装目录（以/home/yashan/install为例）。
$ cd /home/yashan/install
请提前获取存储设备配置信息，用于指定--disk-found-path、--system-data以及--data参数。
# 查询NVMe-oF盘信息
$ ll /dev/nvme*
# 步骤1：生成部署文件
本步骤用于生成YashanDB产品的两个重要的配置文件：hosts.toml和{集群名称}.toml，其中，集群名称来自于--cluster选项的参数值，本文以yashandb为例，该配置文件在下文均称为yashandb.toml。
hosts.toml和yashandb.toml中定义了YashanDB的部署信息和建库信息，也被用于产品之后的扩缩容和升级等操作，因此一旦确认（即部署完成并投入运行）后请不要进行手工调整。
在未进行下一步骤前，本步骤的命令可重复运行，每次运行将直接覆盖之前生成的hosts.toml和yashandb.toml文件。
执行yasboot package ce gen命令生成配置文件，该命令的参数全集请查阅yasboot文档。
以下所展示的命令示例包含了命令的必输入选项，以及我们建议您输入的选项，请根据实际情况自定义选项参数。
$ ./bin/yasboot package ce gen -c yashandb \ -u yashan -p yashan \ --cn-ip 172.16.1.2,172.16.1.3 \ --dn-ip 172.16.1.4,172.16.1.5 \ --install-path /data/yashan/yasdb_home \ --data-path /data/yashan/yasdb_data \ --log-path /data/yashan/yasdb_home/log \ --data /dev/nvme0n3 \ --disk-found-path /dev \ --system-data /dev/nvme0n1执行完毕后，当前目录下将生成hosts.toml和yashandb.toml两个配置文件。
根据实际需要，手动修改配置文件中的相关参数。
Caution:
不建议删除文件中任何行，否则可能导致后续安装过程报错或所搭建的环境后续无法进行扩展配置。
以下列示部分可能需要调整的参数项，完整的配置文件内容说明请查阅配置文件模板介绍，请根据实际情况选择参数项调整值。
参数项 调整说明 所有的LISTEN_ADDR yasom服务和yasagent服务所在地址和监听端口，请检查确保与实际开放的端口号一致，可修改为实际值 dataDisks 数据盘，可修改为实际值 systemDisks 系统盘，可修改为实际值 DN服务器的[host.nvmeof]信息块 DN服务器上NVMe-oF盘的配置信息，例如port表示NVMe-oF监听端口号，请检查确保与实际一致，可修改为实际值
# 步骤2：执行安装
执行如下命令，执行软件包安装。
$ ./bin/yasboot package install -t hosts.toml
| 参数 | 说明 |
|---|---|
| -t, --toml | 部署数据库集群的hosts.toml路径 |
# 步骤3：数据库部署
执行如下命令，部署数据库：
$ ./bin/yasboot cluster deploy -t yashandb.toml --yfs-force-create -p sys_password参数 说明 -t, --toml 部署数据库集群的toml文件路径 --yfs-force-create YFS强制创建diskgroup -p, --sys-password 设置数据库超级管理员sys用户的密码，配置要求如下：
* 密码长度为8 - 64位
* 密码中不能包含对应的数据库用户名称
* 密码必须同时包含数字、字母和特殊字符
* OS命令相关的特殊字符（例如@、/、.、!、$、'等）需进行转义Note:
可通过指定
-d, --child参数展示任务以及子任务信息，从而了解部署进度。返回如下信息表示已成功部署。
task completed, status: SUCCESS执行如下命令，重启数据库：
$ ./bin/yasboot cluster restart -c yashandb
# 步骤4：配置环境变量
部署成功后，--install-path（例如/data/yashan/yasdb_home）指定的目录下会生成子目录{version_number}/conf，该目录下会自动生成YashanDB相关的环境变量文件{集群名称}.bashrc，需将其应用于操作系统。
执行如下命令，生效环境变量。
# 进入环境变量文件所在目录，例如/data/yashan/yasdb_home/{version_number}/conf $ cd /data/yashan/yasdb_home/{version_number}/conf # 生效环境变量 $ cat yashandb.bashrc >> ~/.bashrc $ source ~/.bashrc # 校验环境变量是否生效（回显信息中的路径请以实际为准） $ echo $YASDB_DATA /data/yashan/yasdb_data/db-1-1执行如下命令，配置$YASCS_HOME环境变量。
# 根据前文安装示例实例1-1的路径示例值如下，但节点路径应以实际为准 $ export YASCS_HOME=/data/yashan/yasdb_data/ycs/ce-1-1 # 校验环境变量是否生效（回显信息中的路径请以实际为准） $ echo $YASDB_DATA /data/yashan/yasdb_data/ce-1-1以安装用户登录当前环境中的其他服务器，重复上述操作配置所有环境变量。
# 步骤5：检查安装结果
若连接报错或执行SQL语句报错，请根据错误提示信息检查安装步骤，或咨询我们的技术支持。
执行如下命令，查看数据库状态。
$ yasboot cluster status -c yashandb -d -p sys_password回显信息示例如下：
+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ | hostid | node_type | nodeid | pid | instance_status | database_status | database_role | listen_address | source_node | data_path | +--------------------------------------------------------------------------------------------------------------------------------------------------------------+ | host0001 | ce | 1-1:1 | 22573 | open | normal | primary | 172.16.1.2:1688 | - | /data/yashan/yasdb_data/ce-1-1 | +----------+-----------+--------+-------+-----------------+-----------------+---------------+-------------------+-------------+--------------------------------+ | host0002 | ce | 1-2:2 | 16935 | open | normal | primary | 172.16.1.3:1688 | - | /data/yashan/yasdb_data/ce-1-2 | +----------+-----------+--------+-------+-----------------+-----------------+---------------+-------------------+-------------+--------------------------------+使用yasql工具连接数据库，查看实例状态。
$ yasql sys/********@192.168.1.2:1688 SQL> SELECT STATUS FROM V$INSTANCE; STATUS ------------- OPEN SQL> SELECT database_name FROM v$database; DATABASE_NAME ---------------------------------------------------------------- yashandb
# 步骤6：启动守护进程
执行如下命令，启动守护进程。
$ yasboot monit start --cluster yashandb
Note:
后续使用中服务器重启开机后需手动启动守护进程，守护进程会自动拉起数据库相关进程，从而启动数据库。为简化运维，可将守护进程配置为开机自启动间接实现数据库开机自启动，具体操作请查阅配置开机自启动。
下载文档
复制链接
