数据库托管
YashanDB支持将某个单节点数据库或数据库集群托管到指定的集群内。
#注意事项
- 托管过程需使用yasboot工具，请先下载并解压YashanDB安装包获取工具并了解该工具的各命令选项含义及说明。
- 对于遵照安装部署执行安装的数据库以及已完成托管的数据库，无需执行托管操作。
#操作步骤
除特殊说明，以下步骤均在yasboot工具所在的环境上操作，且命令中的路径、用户、密码等需更换为实际值。
执行如下命令，生成服务器配置文件。
$ ./bin/yasboot package config gen --cluster yashandb -u yashan -p password --ip ip1,ip2,...,ipn --install-path /var/database/yashanCopied!
其中：
-c,--cluster 集群名称，可以取任意名称 -u,--username 服务器ssh用户名 -p,--password 服务器ssh登录密码 -N,--no-password 如果用户配置了免密，请使用这个参数替代-p参数 --ip 部署的IP地址，如果涉及到多个服务器，格式为：ip1,ip2,ip3 --port 服务器ssh连接端口 -i, --install-path 数据库安装路径（HOME目录），可以指定为新规划的HOME目录，必须为空目录 -t, --yas-type 数据库部署的部署形态： * SE：单机部署 * DE：分布式部署 --db 单机db组及节点部署的节点规模，请根据实际主备情况调整此参数Copied!
Note：
该命令会生成服务器配置文件（hosts.toml）和数据库集群配置文件（集群名.toml），且会直接替换/home/yashan/intall目录下原有的hosts.toml文件和集群名.toml（若集群名称一致），托管操作只需使用hosts.toml即可，yashandb.toml可以忽略。
执行如下命令部署主库，并将yasom和yasagent初始化。
$ ./bin/yasboot package install -i yashandb-22.2.4.100-linux-x86_64.tar.gz -t hosts.toml checking install package... install version: yashandb 22.2.4.100 host0001 100% [====================================================================] 3s update host to yasom...Copied!
其中：
-i, --install-pkg 软件包文件本地路径 -t, --toml 服务器配置文件，即hosts.tomlCopied!
执行如下命令，生成托管配置模板文件join_demo.toml。
$ ./bin/yasboot package config join-demo -t SECopied!
其中：
-t, --type 待托管数据库集群的部署形态，SE表示单机部署，DE表示分布式部署Copied!
修改托管配置文件。
如下为托管模板文件各参数描述，请根据实际情况修改模板文件中的参数值：
cluster = "yashandb" --集群名称 sys_password = "yasdb_123" --数据库sys用户的密码 yas_type = "SE" --部署形态 [primary_config] manage_ip = "192.168.1.2" --主节点IP yasdb_home = "/opt/yasom/yashandb/yashandb" --主节点的yasdb_home目录 node_path = "/opt/yasom/yashandb/data/yashandb/db-1-1" --主节点的yasdb_data目录 node_id = "1-1:1" --主节点的nodeid [[standby_config]] --备节点按照主节点的示例修改 manage_ip = "192.168.1.2" yasdb_home = "/opt/yasom/yashandb/yashandb" node_path = "/opt/yasom/yashandb/data/yashandb/db-1-2" node_id = "1-2:1" [[standby_config]] --备节点按照主节点的示例修改，若无可删除 manage_ip = "192.168.1.2" yasdb_home = "/opt/yasom/yashandb/yashandb" node_path = "/opt/yasom/yashandb/data/yashandb/db-1-3" node_id = "1-3:1"Copied!
执行如下命令，进行托管操作。
$ ./bin/yasboot cluster join -t SE --config join_demo.tomlCopied!
其中：
-t, --type 待托管数据库集群的部署形态，SE表示单机部署，DE表示分布式部署 -c, --config 托管配置文件Copied!
命令执行结果如下所示：
the cluster status is as follow: |key |value |------------+------ |clusterName |tp |version |22.2.4.100 the cluster status is as follow: hostid | node_type | nodeid | pid | instance_status | database_status | database_role | listen_address | data_path ------------------------------------------------------------------------------------------------------------------------------------------------- host0001 | db | 1-1:1 | 46689 | open | normal | primary | 192.168.1.2:1688 | /data/yashan/yasdb_data/db-1-1 ----------+-----------+--------+-------+-----------------+-----------------+---------------+----------------+------------------------------------ Check success Are you sure you to add yasdb tp to yasom[yes/no]: yes type | uuid | name | hostid | index | status | return_code | progress | cost ------------------------------------------------------------------------------------------------------- task | e2007922a317a02c | JoinYasdbCluster | - | tp | SUCCESS | 0 | 100 | - ------+------------------+------------------+--------+-------+---------+-------------+----------+------ task completed, status: SUCCESSCopied!
执行如下命令，查看数据库状态。
$ ./bin/yasboot cluster status -c yashandb -d hostid | node_type | nodeid | pid | instance_status | database_status | database_role | listen_address | data_path ----------------------------------------------------------------------------------------------------------------------------------------- host0001 | db | 1-1:1 | 46689 | open | normal | primary | 192.168.1.2:1688 | /data/yashan/yasdb_data/db-1-1 ----------+-----------+--------+-------+-----------------+-----------------+---------------+----------------+----------------------------
