本文内容来自YashanDB官网,原文内容请见 https://doc.yashandb.com/yashandb/23.3/zh/%E5%AE%89%E8%A3%85%...

执行安装部署前,请以安装用户(yashan)登录192.168.1.2服务器,并进入/home/yashan/install安装目录。

$ cd /home/yashan/install

Copied!

步骤1:生成部署文件

  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

Copied!

参数说明
--cluster指定数据库集群名称,该名称也将作为初始数据库的名称(database name)
--port指定SSH服务端口
--install-path指定数据库安装路径
--data-path指定数据存放目录
--begin-port指定数据库监听端口

用于提高数据库性能的参数:

参数说明
--create-cgroup可选参数,指定创建cgroup目录
仅需安装可开启CPU等资源管理的单机数据库(非级联备)时需配置该参数,具体请查阅配置资源管理
--recommend-param可选参数,开启并使用推荐的配置参数
--memory-limit可选参数,服务器的可使用内存百分比上限,须配合--recommend-param使用
--table-type可选参数,主要的业务的表类型,该参数会使数据库配置参数更适合此表类型,须配合--recommend-param使用

执行完毕后,当前目录下将生成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

Copied!

  1. 根据实际需要调整yashandb.toml配置文件中的安装参数,可在group级别设置YashanDB的所有建库参数,可在node级别设置YashanDB的所有配置参数

cluster = "yashandb" 
create_simple_schema = false 
recommend_param = true
table_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" 
    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"

Copied!

步骤2:执行安装

场景一:直接安装。

$ ./bin/yasboot package install -t hosts.toml -i yashandb-23.3.1.100-linux-x86_64.tar.gz 

Copied!

场景二:如需使用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

Copied!

步骤3:部署数据库

$ ./bin/yasboot cluster deploy -t yashandb.toml

Copied!

Note:

可通过指定-d, --child参数展示任务以及子任务信息,以便了解部署进度。

返回如下信息表示已成功部署。

task completed, status: SUCCESS

Copied!

步骤4:配置环境变量

执行如下命令,生效环境变量。


$ cd /data/yashan/yasdb_home/yashandb/23.3.1.100/conf


$ cat yashandb.bashrc >> ~/.bashrc
$ source ~/.bashrc

Copied!

步骤5:检查安装结果

若连接报错或执行SQL语句报错,请根据错误提示信息检查安装步骤,或咨询我们的技术支持。

  1. YashanDB不提供系统初始口令,需使用yasboot工具设置数据库sys用户的密码,以安装用户登录到服务器并执行如下命令设置密码。
$ yasboot cluster password set -n newpasswd -c yashandb

Copied!

  1. 执行如下命令,查看数据库状态。
$ 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  | 54814 | open            | normal          | primary       | 192.168.1.2:1688 | /data/yashan/yasdb_data/db-1-1

Copied!

  1. 使用yasql工具连接数据库,查看实例状态。
$ yasql sys/password@192.168.1.2:1688
SQL> SELECT STATUS FROM V$INSTANCE;

STATUS        
------------- 
OPEN        

SQL> SELECT database_name FROM v$database;

DATABASE_NAME                                                    
---------------------------------------------------------------- 
yashandb     

Copied!

  1. (可选)创建数据库用户并赋权,更多操作请查阅用户管理
SQL> CREATE USER sales IDENTIFIED BY sales;

SQL> GRANT CONNECT TO SALES;

Copied!

Note:

如需开启monit功能,可参考守护进程完成相关配置。

主备部署


步骤1:生成部署文件

  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

Copied!

参数说明
--cluster指定数据库集群名称,该名称也将作为初始数据库的名称(database name)
--port指定SSH服务端口
--install-path指定数据库安装路径
--data-path指定数据存放目录
--begin-port指定数据库监听端口
--create-cgroup可选参数,指定创建cgroup目录
仅需安装可开启CPU资源管理的单机数据库(非级联备)时需配置该参数,具体请查阅配置资源管理
--recommend-param可选参数,开启并使用推荐的配置参数

执行完毕后,当前目录下将生成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

Copied!

  1. 根据实际需要调整yashandb.toml配置文件中的安装参数,可在group级别设置YashanDB的所有建库参数,可在node级别设置YashanDB的所有配置参数

请参考数据库配置调优和自身环境配置调整相关参数。若所安装环境为高可用的Raft集群(自动选主),还需参考高可用


cluster = "yashandb" 
create_simple_schema = false 
recommend_param = true
table_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" 
    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"

Copied!

步骤2:执行安装

场景一:直接安装。

$ ./bin/yasboot package install -t hosts.toml -i yashandb-23.3.1.100-linux-x86_64.tar.gz 

Copied!

场景二:如需使用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

Copied!

步骤3:部署数据库

$ ./bin/yasboot cluster deploy -t yashandb.toml

Copied!

Note:

可通过指定-d, --child参数展示任务以及子任务信息,从而了解部署进度。

返回如下信息表示已成功部署。

task completed, status: SUCCESS

Copied!

步骤4:配置环境变量

以安装用户登录到每个服务器上,执行如下命令生效环境变量。


$ cd /data/yashan/yasdb_home/yashandb/23.3.1.100/conf


$ cat yashandb.bashrc >> ~/.bashrc
$ source ~/.bashrc

Copied!

步骤5:检查安装结果

若连接报错或执行SQL语句报错,请根据错误提示信息检查安装步骤,或咨询我们的技术支持。

  1. YashanDB不提供系统初始口令,需使用yasboot工具设置数据库sys用户的密码,以安装用户登录到服务器并执行如下命令设置密码。
$ yasboot cluster password set -n newpasswd -c yashandb

Copied!

  1. 执行如下命令,查看数据库状态。
$ 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  | 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

Copied!

  1. 使用yasql工具连接数据库,查看实例状态。
$ yasql sys/password@192.168.1.2:1688
SQL> SELECT STATUS FROM V$INSTANCE;

STATUS        
------------- 
OPEN        

SQL> SELECT database_name FROM v$database;

DATABASE_NAME                                                    
---------------------------------------------------------------- 
yashandb     

Copied!

  1. (可选)创建数据库用户并赋权,更多操作请查阅用户管理
SQL> CREATE USER sales IDENTIFIED BY sales;

SQL> GRANT CONNECT TO SALES;

Copied!

Note:

如需开启monit功能,可参考守护进程完成相关配置。

级联备部署


步骤1:生成部署文件

  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

Copied!

参数说明
--cluster指定数据库集群名称,该名称也将作为初始数据库的名称(database name)
--port指定SSH服务端口
--install-path指定数据库安装路径
--data-path指定数据存放目录
--begin-port指定数据库监听端口
--cascade-node级联备节点个数
--cascade-parent级联备绑定备节点的index

执行完毕后,当前目录下将生成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

Copied!

  1. 根据实际需要调整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 

Copied!

场景二:如需使用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

Copied!

步骤3:部署数据库

$ ./bin/yasboot cluster deploy -t yashandb.toml

Copied!

Note:

可通过指定-d, --child参数展示任务以及子任务信息,从而了解部署进度。

返回如下信息表示已成功部署。

task completed, status: SUCCESS

Copied!

步骤4:配置环境变量

以安装用户登录到每个服务器上,执行如下命令生效环境变量。


$ cd /data/yashan/yasdb_home/yashandb/23.3.1.100/conf


$ cat yashandb.bashrc >> ~/.bashrc
$ source ~/.bashrc

Copied!

步骤5:检查安装结果

若连接报错或执行SQL语句报错,请根据错误提示信息检查安装步骤,或咨询我们的技术支持。

  1. YashanDB不提供系统初始口令,需使用yasboot工具设置数据库sys用户的密码,以安装用户登录到服务器并执行如下命令设置密码。
$ yasboot cluster password set -n newpasswd -c yashandb

Copied!

  1. 执行如下命令,查看数据库状态。
$ 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 
----------+-----------+--------+-------+-----------------+-----------------+---------------+-------------+------------------+-------------------------------------------------

Copied!

  1. 使用yasql工具连接数据库,查看实例状态。
$ yasql sys/password@192.168.1.2:1688
SQL> SELECT STATUS FROM V$INSTANCE;

STATUS        
------------- 
OPEN        

SQL> SELECT database_name FROM v$database;

DATABASE_NAME                                                    
---------------------------------------------------------------- 
yashandb     

Copied!

  1. (可选)创建数据库用户并赋权,更多操作请查阅用户管理
SQL> CREATE USER sales IDENTIFIED BY sales;

SQL> GRANT CONNECT TO SALES;

Copied!

Note:

如需开启monit功能,可参考守护进程完成相关配置。

双group异地容灾部署


步骤1:生成部署文件

  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

Copied!

参数说明
--cluster指定数据库集群名称,该名称也将作为初始数据库的名称(database name)
--port指定SSH服务端口
--install-path指定数据库安装路径
--data-path指定数据存放目录
--begin-port指定数据库监听端口
--group单机group的个数,默认为1
--standby-node单机备group的节点个数

执行完毕后,当前目录下将生成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

Copied!

  1. 根据实际需要调整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 

Copied!

场景二:如需使用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

Copied!

步骤3:部署数据库

$ ./bin/yasboot cluster deploy -t yashandb.toml

Copied!

Note:

可通过指定-d, --child参数展示任务以及子任务信息,从而了解部署进度。

返回如下信息表示已成功部署。

task completed, status: SUCCESS

Copied!

步骤4:配置环境变量

以安装用户登录到每个服务器上,执行如下命令生效环境变量。


$ cd /data/yashan/yasdb_home/yashandb/23.3.1.100/conf


$ cat yashandb.bashrc >> ~/.bashrc
$ source ~/.bashrc

Copied!

步骤5:检查安装结果

若连接报错或执行SQL语句报错,请根据错误提示信息检查安装步骤,或咨询我们的技术支持。

  1. YashanDB不提供系统初始口令,需使用yasboot工具设置数据库sys用户的密码,以安装用户登录到服务器并执行如下命令设置密码。
$ yasboot cluster password set -n newpasswd -c yashandb

Copied!

  1. 执行如下命令,查看数据库状态。
$ 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 
----------+-----------+--------+-------+-----------------+-----------------+---------------+-------------+----------------+-------------------------------------------------

Copied!

  1. 使用yasql工具连接数据库,查看实例状态。
$ yasql sys/password@192.168.1.2:1688
SQL> SELECT STATUS FROM V$INSTANCE;

STATUS        
------------- 
OPEN        

SQL> SELECT database_name FROM v$database;

DATABASE_NAME                                                    
---------------------------------------------------------------- 
yashandb     

Copied!

  1. (可选)创建数据库用户并赋权,更多操作请查阅用户管理
SQL> CREATE USER sales IDENTIFIED BY sales;

SQL> GRANT CONNECT TO SALES;

Copied!

Note:

如需开启monit功能,可参考守护进程完成相关配置。

在双group异地容灾部署环境中,执行数据库恢复操作后的实例均会成为主库,若目标实例为备库且原主库存活则不可对该实例执行恢复操作,否则会出现双主导致部署状态或数据异常。如需重建备库请执行备库BUILD操作。


YashanDB
1 声望0 粉丝

崖山数据库系统YashanDB是深圳计算科学研究院自主设计研发的新型数据库管理系统,融入原创的有界计算、近似计算、并行可扩展和跨模融合计算理论,可满足金融、政企、能源等关键行业对高性能、高并发及高安全性的...