本文内容来自 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/YashanDB%E6%9C%8D%E5%8A%A1%E7%AB%AF%E5%AE%89%E8%A3%85%EF%BC%88%E5%91%BD%E4%BB%A4%E8%A1%8C%EF%BC%89/%E5%8D%95%E6%9C%BA%EF%BC%88%E4%B8%BB%E5%A4%87%EF%BC%89%E9%83%A8%E7%BD%B2.html
执行安装部署前，请以安装用户（yashan）登录 192.168.1.2 服务器，并进入/home/yashan/install 安装目录。
$ cd /home/yashan/install
复制代码
步骤 1：生成部署文件
执行 yasboot package 命令生成配置文件，命令详细参数可查阅yasboot。
$ ./bin/yasboot package se gen --cluster yashandb --recommend-param \-u yashan -p password --ip 192.168.1.2 --port 22 \--install-path /data/yashan/yasdb_home --data-path /data/yashan/yasdb_data \--begin-port 1688
复制代码
用于提高数据库性能的参数：
执行完毕后，当前目录下将生成 yashandb.toml 和 hosts.toml 两个配置文件，可手动修改，但不建议删除文件中任何行，否则可能导致后续安装过程报错，或所搭建的环境后续无法进行扩展配置。
-rw-------. 1 yashan yashan 444 Aug 31 16:27 hosts.toml-rw-------. 1 yashan yashan 708 Aug 31 16:27 yashandb.toml
复制代码
根据实际需要调整 yashandb.toml 配置文件中的安装参数，可在 group 级别设置 YashanDB 的所有建库参数，可在 node 级别设置 YashanDB 的所有配置参数。
# 以下内容以实际展示结果为准cluster = "yashandb" # 安装后修改也不会生效，除非重新安装create_simple_schema = false # 为true部署完会执行示例的SQL，若改为true需要在deploy时指定sys-password参数recommend_param = truetable_type = "HEAP"uuid = "64f04f0e999c72db72bd565762e6a4ea" # 系统自动生成，不建议修改yas_type = "SE" # 部署模式，安装后修改也不会生效，除非重新安装
[[group]] group_type = "db" # 安装后修改也不会生效，除非重新安装 name = "dbg1" # 安装后修改也不会生效，除非重新安装 [group.config] # 可配置所有建库参数，不配置时采用默认值 CHARACTER_SET = "utf8" ISARCHIVELOG = true REDO_FILE_NUM = 4 REDO_FILE_SIZE = "128M"
[[group.node]] data_path = "/data/yashan/yasdb_data" # 为DATA目录，安装后修改也不会生效，除非重新安装 hostid = "host0001" # 安装后修改也不会生效，除非重新安装 role = 1 # 数据库主备角色，安装后修改也不会生效，除非重新安装 [group.node.config] # 可配置所有数据库参数，不配置时采用默认值，安装后修改可以生效（只读参数不可修改） LISTEN_ADDR = "192.168.1.2:1688" REPLICATION_ADDR = "192.168.1.2:1689" RUN_LOG_FILE_PATH = "/data/yashan/yasdb_home/yashandb/23.3.1.100/log/yashandb/db-1-1/run" RUN_LOG_LEVEL = "INFO" SLOW_LOG_FILE_PATH = "/data/yashan/yasdb_home/yashandb/23.3.1.100/log/yashandb/db-1-1/slow"
复制代码
步骤 2：执行安装
场景一：直接安装。
$ ./bin/yasboot package install -t hosts.toml -i yashandb-23.3.1.100-linux-x86_64.tar.gz
复制代码
场景二：如需使用 DBLINK 功能以及更丰富的内置函数（例如 GIS Function、LSFA_LISTAGG），需先下载plugin插件包并在安装命令中指定--plugin 参数。安装完成后，无法单独安装该插件包。
$ ./bin/yasboot package install -t hosts.toml -i yashandb-23.3.1.100-linux-x86_64.tar.gz --plugin yashandb-plugins-all-23.3.1.100-linux-x86_64.tar.gz
复制代码
步骤 3：部署数据库
$ ./bin/yasboot cluster deploy -t yashandb.toml
复制代码
Note:
可通过指定-d, --child参数展示任务以及子任务信息，以便了解部署进度。
返回如下信息表示已成功部署。
task completed, status: SUCCESS
复制代码
步骤 4：配置环境变量
执行如下命令，生效环境变量。
#部署命令成功执行后将会在$YASDB_HOME目录下的conf文件夹中生成<<集群名称>>.bashrc环境变量文件$ cd /data/yashan/yasdb_home/yashandb/23.3.1.100/conf# 如~/.bashrc中已存在YashanDB相关的环境变量，将其清除$ cat yashandb.bashrc >> ~/.bashrc$ source ~/.bashrc
复制代码
步骤 5：检查安装结果
若连接报错或执行 SQL 语句报错，请根据错误提示信息检查安装步骤，或咨询我们的技术支持。
YashanDB 不提供系统初始口令，需使用yasboot工具设置数据库 sys 用户的密码，以安装用户登录到服务器并执行如下命令设置密码。
$ yasboot cluster password set -n newpasswd -c yashandb
复制代码
执行如下命令，查看数据库状态。
$ yasboot cluster status -c yashandb -dhostid | node_type | nodeid | pid | instance_status | database_status | database_role | listen_address | data_path --------------------------------------------------------------------------------------------------------------------------------------------------------------host0001 | db | 1-1:1 | 54814 | open | normal | primary | 192.168.1.2:1688 | /data/yashan/yasdb_data/db-1-1
复制代码
使用yasql工具连接数据库，查看实例状态。
$ yasql sys/password@192.168.1.2:1688SQL> SELECT STATUS FROM V$INSTANCE;
STATUS ------------- OPEN
SQL> SELECT database_name FROM v$database;
DATABASE_NAME ---------------------------------------------------------------- yashandb
复制代码
（可选）创建数据库用户并赋权，更多操作请查阅用户管理。
SQL> CREATE USER sales IDENTIFIED BY sales;
SQL> GRANT CONNECT TO SALES;
复制代码
Note:
如需开启 monit 功能，可参考守护进程完成相关配置。
主备部署
步骤 1：生成部署文件
执行 yasboot package 命令生成配置文件，命令详细参数可查阅yasboot。
$ ./bin/yasboot package se gen --cluster yashandb --recommend-param \ -u yashan -p password --ip 192.168.1.2,192.168.1.3,192.168.1.4 --port 22 \ --install-path /data/yashan/yasdb_home --data-path /data/yashan/yasdb_data \ --begin-port 1688 --node 3
复制代码
执行完毕后，当前目录下将生成 yashandb.toml 和 hosts.toml 两个配置文件，可手动修改，但不建议删除文件中任何行，否则可能导致后续安装过程报错，或所搭建的环境后续无法进行扩展配置。
-rw-------. 1 yashan yashan 444 Aug 31 16:27 hosts.toml -rw-------. 1 yashan yashan 708 Aug 31 16:27 yashandb.toml
复制代码
根据实际需要调整 yashandb.toml 配置文件中的安装参数，可在 group 级别设置 YashanDB 的所有建库参数，可在 node 级别设置 YashanDB 的所有配置参数。
请参考数据库配置调优和自身环境配置调整相关参数。若所安装环境为高可用的 Raft 集群（自动选主），还需参考高可用。
# 以下内容以实际展示结果为准cluster = "yashandb" # 安装后修改也不会生效，除非重新安装create_simple_schema = false # 为true部署完会执行示例的SQL，若改为true需要在deploy时指定sys-password参数recommend_param = truetable_type = "HEAP"uuid = "64f04f0e999c72db72bd565762e6a4ea" # 系统自动生成，不建议修改yas_type = "SE" # 部署模式，安装后修改也不会生效，除非重新安装
[[group]] group_type = "db" # 安装后修改也不会生效，除非重新安装 name = "dbg1" # 安装后修改也不会生效，除非重新安装 [group.config] # 可配置所有建库参数，不配置时采用默认值 CHARACTER_SET = "utf8" ISARCHIVELOG = true REDO_FILE_NUM = 4 REDO_FILE_SIZE = "128M"
[[group.node]] data_path = "/data/yashan/yasdb_data" # 为DATA目录，安装后修改也不会生效，除非重新安装 hostid = "host0001" # 安装后修改也不会生效，除非重新安装 role = 1 # 数据库主备角色，安装后修改也不会生效，除非重新安装 [group.node.config] # 可配置所有数据库参数，不配置时采用默认值，安装后修改可以生效（只读参数不可修改） LISTEN_ADDR = "192.168.1.2:1688" REPLICATION_ADDR = "192.168.1.2:1689" RUN_LOG_FILE_PATH = "/data/yashan/yasdb_home/yashandb/23.3.1.100/log/yashandb/db-1-1/run" RUN_LOG_LEVEL = "INFO" SLOW_LOG_FILE_PATH = "/data/yashan/yasdb_home/yashandb/23.3.1.100/log/yashandb/db-1-1/slow"
[[group.node]] data_path = "/data/yashan/yasdb_data" hostid = "host0002" role = 2 [group.node.config] LISTEN_ADDR = "192.168.1.3:1688" REPLICATION_ADDR = "192.168.1.3:1689" RUN_LOG_FILE_PATH = "/data/yashan/yasdb_home/yashandb/23.3.1.100/log/yashandb/db-1-2/run" RUN_LOG_LEVEL = "INFO" SLOW_LOG_FILE_PATH = "/data/yashan/yasdb_home/yashandb/23.3.1.100/log/yashandb/db-1-2/slow" [[group.node]] data_path = "/data/yashan/yasdb_data" hostid = "host0003" role = 2 [group.node.config] LISTEN_ADDR = "192.168.1.4:1688" REPLICATION_ADDR = "192.168.1.4:1689" RUN_LOG_FILE_PATH = "/data/yashan/yasdb_home/yashandb/23.3.1.100/log/yashandb/db-1-3/run" RUN_LOG_LEVEL = "INFO" SLOW_LOG_FILE_PATH = "/data/yashan/yasdb_home/yashandb/23.3.1.100/log/yashandb/db-1-3/slow"
复制代码
步骤 2：执行安装
场景一：直接安装。
$ ./bin/yasboot package install -t hosts.toml -i yashandb-23.3.1.100-linux-x86_64.tar.gz
复制代码
场景二：如需使用 DBLINK 功能以及更丰富的内置函数（例如 GIS Function、LSFA_LISTAGG），需先下载plugin插件包并在安装命令中指定--plugin 参数。安装完成后，无法单独安装该插件包。
$ ./bin/yasboot package install -t hosts.toml -i yashandb-23.3.1.100-linux-x86_64.tar.gz --plugin yashandb-plugins-all-23.3.1.100-linux-x86_64.tar.gz
复制代码
步骤 3：部署数据库
$ ./bin/yasboot cluster deploy -t yashandb.toml
复制代码
Note:
可通过指定-d, --child参数展示任务以及子任务信息，从而了解部署进度。
返回如下信息表示已成功部署。
task completed, status: SUCCESS
复制代码
步骤 4：配置环境变量
以安装用户登录到每个服务器上，执行如下命令生效环境变量。
# 部署命令成功执行后将会在$YASDB_HOME目录下的conf文件夹中生成<<集群名称>>.bashrc环境变量文件$ cd /data/yashan/yasdb_home/yashandb/23.3.1.100/conf# 如~/.bashrc中已存在YashanDB相关的环境变量，将其清除
$ cat yashandb.bashrc >> ~/.bashrc$ source ~/.bashrc
复制代码
步骤 5：检查安装结果
若连接报错或执行 SQL 语句报错，请根据错误提示信息检查安装步骤，或咨询我们的技术支持。
YashanDB 不提供系统初始口令，需使用yasboot工具设置数据库 sys 用户的密码，以安装用户登录到服务器并执行如下命令设置密码。
$ yasboot cluster password set -n newpasswd -c yashandb
复制代码
执行如下命令，查看数据库状态。
$ yasboot cluster status -c yashandb -dhostid | node_type | nodeid | pid | instance_status | database_status | database_role | listen_address | data_path --------------------------------------------------------------------------------------------------------------------------------------------------------------host0001 | db | 1-1:1 | 54814 | open | normal | primary | 192.168.1.2:1688 | /data/yashan/yasdb_data/db-1-1--------------------------------------------------------------------------------------------------------------------------------------------------------------host0002 | db | 1-2:2 | 49529 | open | normal | standby | 192.168.1.3:1688 | /data/yashan/yasdb_data/db-1-2--------------------------------------------------------------------------------------------------------------------------------------------------------------host0003 | db | 1-3:3 | 49582 | open | normal | standby | 192.168.1.4:1688 | /data/yashan/yasdb_data/db-1-3
复制代码
使用yasql工具连接数据库，查看实例状态。
$ yasql sys/password@192.168.1.2:1688SQL> SELECT STATUS FROM V$INSTANCE;
STATUS ------------- OPEN
SQL> SELECT database_name FROM v$database;
DATABASE_NAME ---------------------------------------------------------------- yashandb
复制代码
（可选）创建数据库用户并赋权，更多操作请查阅用户管理。
SQL> CREATE USER sales IDENTIFIED BY sales;
SQL> GRANT CONNECT TO SALES;
复制代码
Note:
如需开启 monit 功能，可参考守护进程完成相关配置。
级联备部署
步骤 1：生成部署文件
执行 yasboot package 命令生成配置文件，命令详细参数可查阅yasboot。
$ ./bin/yasboot package se gen --cluster yashandb -u yashan -p password --ip 192.168.1.2,192.168.1.3,192.168.1.4 --port 22 --install-path /data/yashan/yasdb_home --data-path /data/yashan/yasdb_data --begin-port 1688 --node 2 --cascade-node 1 --cascade-parent 1
复制代码
执行完毕后，当前目录下将生成 yashandb.toml 和 hosts.toml 两个配置文件，可手动修改，但不建议删除文件中任何行，否则可能导致后续安装过程报错，或所搭建的环境后续无法进行扩展配置。
-rw-------. 1 yashan yashan 444 Aug 31 16:27 hosts.toml -rw-------. 1 yashan yashan 708 Aug 31 16:27 yashandb.toml
复制代码
根据实际需要调整 yashandb.toml 配置文件中的安装参数，可在 group 级别设置 YashanDB 的所有建库参数，可在 node 级别设置 YashanDB 的所有配置参数。
请参考数据库配置调优和自身环境配置调整相关参数。若所安装环境为高可用的 Raft 集群（自动选主），还需参考高可用。
步骤 2：执行安装
场景一：直接安装。
$ ./bin/yasboot package install -t hosts.toml -i yashandb-23.3.1.100-linux-x86_64.tar.gz
复制代码
场景二：如需使用 DBLINK 功能以及更丰富的内置函数（例如 GIS Function、LSFA_LISTAGG），需先下载plugin插件包并在安装命令中指定--plugin 参数。安装完成后，无法单独安装该插件包。
$ ./bin/yasboot package install -t hosts.toml -i yashandb-23.3.1.100-linux-x86_64.tar.gz --plugin yashandb-plugins-all-23.3.1.100-linux-x86_64.tar.gz
复制代码
步骤 3：部署数据库
$ ./bin/yasboot cluster deploy -t yashandb.toml
复制代码
Note:
可通过指定-d, --child参数展示任务以及子任务信息，从而了解部署进度。
返回如下信息表示已成功部署。
task completed, status: SUCCESS
复制代码
步骤 4：配置环境变量
以安装用户登录到每个服务器上，执行如下命令生效环境变量。
# 部署命令成功执行后将会在$YASDB_HOME目录下的conf文件夹中生成<<集群名称>>.bashrc环境变量文件$ cd /data/yashan/yasdb_home/yashandb/23.3.1.100/conf# 如~/.bashrc中已存在YashanDB相关的环境变量，将其清除
$ cat yashandb.bashrc >> ~/.bashrc$ source ~/.bashrc
复制代码
步骤 5：检查安装结果
若连接报错或执行 SQL 语句报错，请根据错误提示信息检查安装步骤，或咨询我们的技术支持。
YashanDB 不提供系统初始口令，需使用yasboot工具设置数据库 sys 用户的密码，以安装用户登录到服务器并执行如下命令设置密码。
$ yasboot cluster password set -n newpasswd -c yashandb
复制代码
执行如下命令，查看数据库状态。
$ yasboot cluster status -c yashandb -d hostid | node_type | nodeid | pid | instance_status | database_status | database_role | source_node | listen_address | data_path ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- host0001 | db | 1-1:1 | 73152 | open | normal | primary | - | 192.168.1.2:1688 | /data/yashan/yasdb_data/db-1-1----------+-----------+--------+-------+-----------------+-----------------+---------------+-------------+------------------+------------------------------------------------- host0002 | db | 1-2:2 | 73211 | open | normal | standby | 1-1:1 | 192.168.1.3:1688 | /data/yashan/yasdb_data/db-1-2 ----------+-----------+--------+-------+-----------------+-----------------+---------------+-------------+------------------+------------------------------------------------- host0003 | db | 1-3:3 | 73403 | open | normal | standby | 1-2:2 | 192.168.1.4:1688 | /data/yashan/yasdb_data/db-1-3 ----------+-----------+--------+-------+-----------------+-----------------+---------------+-------------+------------------+-------------------------------------------------
复制代码
使用yasql工具连接数据库，查看实例状态。
$ yasql sys/password@192.168.1.2:1688SQL> SELECT STATUS FROM V$INSTANCE;
STATUS ------------- OPEN
SQL> SELECT database_name FROM v$database;
DATABASE_NAME ---------------------------------------------------------------- yashandb
复制代码
（可选）创建数据库用户并赋权，更多操作请查阅用户管理。
SQL> CREATE USER sales IDENTIFIED BY sales;
SQL> GRANT CONNECT TO SALES;
复制代码
Note:
如需开启 monit 功能，可参考守护进程完成相关配置。
双 group 异地容灾部署
步骤 1：生成部署文件
执行 yasboot package 命令生成配置文件，命令详细参数可查阅yasboot。
$ ./bin/yasboot package se gen --cluster yashandb -u yashan -p password --ip 192.168.1.2,192.168.1.3,192.168.1.4 --port 22 --install-path /data/yashan/yasdb_home --data-path /data/yashan/yasdb_data --begin-port 1688 --node 3 --group 2 --standby-node 3
复制代码
执行完毕后，当前目录下将生成 yashandb.toml 和 hosts.toml 两个配置文件，可手动修改，但不建议删除文件中任何行，否则可能导致后续安装过程报错，或所搭建的环境后续无法进行扩展配置。
-rw-------. 1 yashan yashan 444 Aug 31 16:27 hosts.toml -rw-------. 1 yashan yashan 708 Aug 31 16:27 yashandb.toml
复制代码
根据实际需要调整 yashandb.toml 配置文件中的安装参数，可在 group 级别设置 YashanDB 的所有建库参数，可在 node 级别设置 YashanDB 的所有配置参数。
请参考数据库配置调优和自身环境配置调整相关参数。若所安装环境为高可用的 Raft 集群（自动选主），还需参考高可用。
步骤 2：执行安装
场景一：直接安装。
$ ./bin/yasboot package install -t hosts.toml -i yashandb-23.3.1.100-linux-x86_64.tar.gz
复制代码
场景二：如需使用 DBLINK 功能以及更丰富的内置函数（例如 GIS Function、LSFA_LISTAGG），需先下载plugin插件包并在安装命令中指定--plugin 参数。安装完成后，无法单独安装该插件包。
$ ./bin/yasboot package install -t hosts.toml -i yashandb-23.3.1.100-linux-x86_64.tar.gz --plugin yashandb-plugins-all-23.3.1.100-linux-x86_64.tar.gz
复制代码
步骤 3：部署数据库
$ ./bin/yasboot cluster deploy -t yashandb.toml
复制代码
Note:
可通过指定-d, --child参数展示任务以及子任务信息，从而了解部署进度。
返回如下信息表示已成功部署。
task completed, status: SUCCESS
复制代码
步骤 4：配置环境变量
以安装用户登录到每个服务器上，执行如下命令生效环境变量。
# 部署命令成功执行后将会在$YASDB_HOME目录下的conf文件夹中生成<<集群名称>>.bashrc环境变量文件$ cd /data/yashan/yasdb_home/yashandb/23.3.1.100/conf# 如~/.bashrc中已存在YashanDB相关的环境变量，将其清除
$ cat yashandb.bashrc >> ~/.bashrc$ source ~/.bashrc
复制代码
步骤 5：检查安装结果
若连接报错或执行 SQL 语句报错，请根据错误提示信息检查安装步骤，或咨询我们的技术支持。
YashanDB 不提供系统初始口令，需使用yasboot工具设置数据库 sys 用户的密码，以安装用户登录到服务器并执行如下命令设置密码。
$ yasboot cluster password set -n newpasswd -c yashandb
复制代码
执行如下命令，查看数据库状态。
$ yasboot cluster status -c yashandb -d hostid | node_type | nodeid | pid | instance_status | database_status | database_role | source_node | listen_address | data_path ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- host0001 | db | 1-1:1 | 73132 | open | normal | primary | - | 192.168.1.2:1688 | /data/yashan/yasdb_data/db-1-1 +-----------+--------+-------+-----------------+-----------------+---------------+-------------+----------------+------------------------------------------------- | db | 1-2:2 | 73199 | open | normal | standby | 1-1:1 | 192.168.1.2:1690 | /data/yashan/yasdb_data/db-1-2 +-----------+--------+-------+-----------------+-----------------+---------------+-------------+----------------+------------------------------------------------- | db | 1-3:3 | 73201 | open | normal | standby | 1-1:1 | 192.168.1.2:1692 | /data/yashan/yasdb_data/db-1-3 ---------+-----------+--------+-------+-----------------+-----------------+---------------+-------------+----------------+------------------------------------------------- host0002 | db | 2-1:4 | 73362 | open | normal | standby | 1-1:1 | 192.168.1.3:1688 | /data/yashan/yasdb_data/db-2-1 +-----------+--------+-------+-----------------+-----------------+---------------+-------------+----------------+------------------------------------------------- | db | 2-2:5 | 73435 | open | normal | standby | 2-1:4 | 192.168.1.3:1690 | /data/yashan/yasdb_data/db-2-2 +-----------+--------+-------+-----------------+-----------------+---------------+-------------+----------------+------------------------------------------------- | db | 2-3:6 | 73499 | open | normal | standby | 2-1:4 | 192.168.1.3:1692 | /data/yashan/yasdb_data/db-2-3 ----------+-----------+--------+-------+-----------------+-----------------+---------------+-------------+----------------+-------------------------------------------------
复制代码
使用yasql工具连接数据库，查看实例状态。
$ yasql sys/password@192.168.1.2:1688SQL> SELECT STATUS FROM V$INSTANCE;
STATUS ------------- OPEN
SQL> SELECT database_name FROM v$database;
DATABASE_NAME ---------------------------------------------------------------- yashandb
复制代码
（可选）创建数据库用户并赋权，更多操作请查阅用户管理。
SQL> CREATE USER sales IDENTIFIED BY sales;
SQL> GRANT CONNECT TO SALES;
复制代码
Note:
如需开启 monit 功能，可参考守护进程完成相关配置。
在双 group 异地容灾部署环境中，执行数据库恢复操作后的实例均会成为主库，若目标实例为备库且原主库存活则不可对该实例执行恢复操作，否则会出现双主导致部署状态或数据异常。如需重建备库请执行备库 BUILD 操作。
评论