1.Base基础/3.Icon图标/操作/search备份
1.Base基础/3.Icon图标/操作/search备份
EN
文档
AntDB简介
快速入门
安装部署
初始化与启动
环境注意项
用户手册
数据安全
系统架构
最佳实践
参考指南
  • 文档首页 /
  • 快速入门 /
  • 初始化与启动 /
  • 初始化与启动

初始化与启动

更新时间:2024-04-17 12:43:32
  • antdb_init.sh
参数说明
-h|--help查看帮助信息
-c|--config根据配置文件对环境进行初始化部署
-v|-V|--version查看工具版本
  • 集中式

初始化方式分为两种:不使用配置文件的“简易初始化”,和指定配置文件的“自定义初始化”。

  • 简易初始化:

    1. 执行方式如下

      ./antdb_init.sh
      
    2. 初始化完成后,会生成默认的数据库用户,用户名 antdb,密码 antdb。其它信息也会显示在屏幕上,例如:

      [Info] AntDB info:
      +----------+-----------+------+----------------------------------+-------+----------+
      | database |    ip     | port |               data               | user  | password |
      +----------+-----------+------+----------------------------------+-------+----------+
      | antdb    | localhost | 6655 | /home/installtest/app/antdb/data | antdb | antdb    |
      +----------+-----------+------+----------------------------------+-------+----------+
      
  • 自定义初始化:

    1. 编辑 setup/common/initconf-c.ini,与构建环境保持一致,各参数说明参考下文

    2. 执行如下命令进行初始化部署

      ./antdb_init.sh -c setup/common/initconf-c.ini
      
    3. 执行完成后,会输出集群的部署信息。例如

      [Info] AntDB config:
      +---------------------------------------------+
      |               Config                        +
      +---------------------------------------------+
      | /etc/etcd/etcd_antdbcluster.yaml            |
      | /etc/patroni/patroni_antdbcluster.yaml      |
      +---------------------------------------------+
      
      [Info] AntDB cluster:
      
      + Cluster: antdbcluster (7214059048160288817) -+---------+----+-----------+
      | Member    | Host              | Role         | State   | TL | Lag in MB |
      +-----------+-------------------+--------------+---------+----+-----------+
      | patroni-1 | 10.1.206.131:6612 | Leader       | running |  2 |           |
      | patroni-2 | 10.1.206.132:6432 | Sync Standby | running |  2 |         0 |
      | patroni-3 | 10.1.206.133:6432 | Replica      | running |  2 |         0 |
      +-----------+-------------------+--------------+---------+----+-----------+
      
  • 分布式

    1. 编辑 setup/common/initconf-d.ini,与构建环境保持一致,各参数说明参考下文

    2. 执行如下命令进行初始化部署

      ./antdb_init.sh -c setup/common/initconf-d.ini
      
    3. 执行完成后,会输出集群的部署信息。例如

      +----------+--------------------+--------+-------------+--------------+-------+----------+-------------------------------+----------+
      | nodename |      nodetype      | status | description |     host     | port  | recovery |           boot time           | nodezone |
      +----------+--------------------+--------+-------------+--------------+-------+----------+-------------------------------+----------+
      | gc_1     | gtmcoord master    | t      | running     | 10.1.206.132 | 60995 | false    | 2023-03-24 10:24:38.344137+08 | local    |
      | cn1      | coordinator master | t      | running     | 10.1.206.133 | 60601 | false    | 2023-03-24 10:24:42.28489+08  | local    |
      | dn1      | datanode master    | t      | running     | 10.1.206.131 | 60604 | false    | 2023-03-24 10:24:46.781569+08 | local    |
      | dn2      | datanode master    | t      | running     | 10.1.206.132 | 60605 | false    | 2023-03-24 10:24:43.307056+08 | local    |
      | dn3      | datanode master    | t      | running     | 10.1.206.133 | 60606 | false    | 2023-03-24 10:24:46.078949+08 | local    |
      +----------+--------------------+--------+-------------+--------------+-------+----------+-------------------------------+----------+
      
  • 配置文件说明

    根据上面示例所示,配置文件位于 setup/common 中,initconf-c.ini 为集中式配置文件,initconf-d.ini 为分布式配置文件。各个配置文件中的参数说明如下:

    集中式:

    1. [clusterinfo]
      • cluster_type:表示数据库初始化的类型,C_ALONE 为单机版;C_HA 为集中式高可用版。如果是 C_HA 时,需要同时需要填写 standby_info、etcd_info、patroni_info。
      • cluster_name:数据库集簇的名称,作为标识使用,无特殊要求。
      • cluster_user:执行此安装程序的用户,初始化完成后,这个用户就是一个超级用户。
    2. [primary_info]
      • primary_ip:主节点数据库 ip,即执行此安装程序的主机 ip。
      • primary_sshport:执行此安装程序的主机的 SSH 服务端口号。
      • antdb_apppath:执行此程序的节点的数据库二进制程序的安装目录,即安装时指定的目录。
      • antdb_datapath:数据库初始化时的数据目录,需要设定为空目录。
      • antdb_port:数据库的端口号。
      • antdb_password:数据库的超级用户的初始密码。
    3. [standby_info]
      • standby_node:备节点的明细信息,逗号分隔。分别为备节点名称、备节点ip地址、备节点SSH服务端口号、备节点数据库程序目录、备节点数据库数据目录、备节点数据库端口号。
    4. [etcd_info]
      • etcd_node:etcd的详细配置信息,逗号分隔。分别为etcd节点名称、etcd数据目录、etcd客户端连接端口、etcd通信端口、etcd所在的节点名称(与数据库节点名称对应,如上述的primary,standby_node中的名称)。
    5. [patroni_info]
      • patroni_node:patroni的信息配置信息,逗号分隔。分别为patroni节点名称、patroni端口、patroni所在的节点名称(与数据库节点名称对应)。

    分布式:

    1. [clusterinfo]
      • cluster_type:表示数据库初始化的类型,D 为分布式。
      • cluster_name:数据库集簇的名称,作为标识使用,无特殊要求。
      • cluster_user:执行此安装程序的用户,初始化完成后,这个用户就是一个超级用户。
    2. [mgr_info]
      • primary_ip:主节点数据库 ip,即执行此安装程序的主机 ip。
      • primary_sshport:执行此安装程序的主机的 SSH 服务端口号。
      • antdb_apppath:执行此程序的节点的数据库二进制程序的安装目录,即安装时指定的目录。
      • antdb_datapath:数据库初始化时的数据目录,需要设定为空目录。
      • antdb_port:数据库的端口号。
      • antdb_password:数据库的超级用户的初始密码。
    3. [host_info]
      • host:分布式主机信息,逗号分隔。分别为节点名称、主机间通信端口、主机间通信方式(暂时只支持ssh通信)、数据库二进制程序的安装目录、数据库代理程序端口号、主机上操作系统用户(通常与clusterinfo配置为同一用户)、主机ip地址。
    4. [node_info]
      • node:分布式数据库中各个角色的详细信息,逗号分隔。分别为角色名称、角色类型(GC、CN、DN)、角色所在主机名称(与host_info对应)、角色的数据库端口号、角色的数据目录、角色的身份(master、slave)、角色对应的主库的角色名称、角色的数据同步模式(如果节点为slave,则需要最后两个配置项;分别为master节点名称、自身的同步模式)
问题反馈