YashanDB 单机（主备）部署

原创

用户10349277

修改于 2025-03-06 11:04:21

4400

代码可运行

运行总次数：0

代码可运行

执行安装部署前，请以安装用户（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 两个配置文件，可手动修改，但不建议删除文件中任何行，否则可能导致后续安装过程报错，或所搭建的环境后续无法进行扩展配置。

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

复制代码

$ ./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

复制代码

$ ./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

复制代码

$ ./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 操作。

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

数据库

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

数据库

登录后参与评论

0 条评论

热度