YashanDB 分布式可视化部署

步骤 1：启动 Web 服务

1. 以 yashan 用户登录 192.168.1.2 服务器。

2. 执行如下命令，进入安装目录。

$ cd /home/yashan/install

3.执行如下命令，使用 yasom 启动 Web 服务端：

$ ./bin/yasom --web --listen 192.168.1.2:9001

• -web：指定以 Web 服务端启动。

• --listen：指定监听的地址（即可视化安装的网页地址），格式为IP:PORT，通常设置为当前服务器的 IP，端口推荐使用 9001。

4.在 PC 端浏览器中访问可视化安装的网页地址。

步骤 2：配置数据库基本信息与服务器信息

1. 根据实际情况，配置数据库基本信息：

• 数据库名称：填写数据库集群名称，该名称也将作为初始数据库的名称（database name）。必须以字母开头，长度为[1,63]个字符，例如 yashandb。

• 数据库类型：选择数据库部署形态，例如分布式。

• 安装包路径：填写安装包所在路径，安装用户需有该路径的操作权限，例如/home/yashan/install/yashandb-23.3.1.100-linux-x86_64.tar.gz。

• 插件包路径：选填参数，如需使用 DBLINK 功能以及更丰富的内置函数（例如 LSFA_LISTAGG 函数），需先下载plugin插件包至服务器并填写插件包所在路径，安装用户需有该路径的操作权限，例如/home/yashan/install/yashandb-plugins-all-23.3.1.100-linux-x86_64.tar.gz。安装完成后，无法单独安装该插件包。

2.在服务器列表中，默认识别 Web 服务所在服务器的信息，检查确认安装路径等信息无误后单击【尝试连接】检查连通性。

3.单击服务器列表上方的【添加】。

4.在弹出的对话框中，配置其他服务器信息，单击【确定】保存配置。

• 主机地址：服务器的 IP 地址，格式：192.168.1.3或192.168.1.[3-4]，允许配置多个 IP 地址/集，使用换行符分割。

• 用户名：安装用户的名称，例如 yashan。

• 密码：可选参数，安装用户的密码，若已配置当前服务器对其他服务器 SSH 免密，无需填写密码。

• SSH 端口：SSH 端口，例如 22。

• 安装路径：数据库安装路径，即安装前划分的安装目录，例如/data/yashan/yasdb_home。

5.单击【全部尝试连接】检查连通性。

6.确认信息无误后，单击【下一步】。

步骤 3：配置服务器 sudo

1. 在数据库配置区域，可以配置以下功能：

• 创建 cgroup：开启表示创建用于 YashanDB CPU 资源管理的 cgoup 目录，并需填写服务器其他配置区域的 cgroup 目录。仅需安装可开启 CPU 资源管理的数据库（非级联备）时需配置该参数，具体请查阅配置资源管理。

• 开机自启 monit：如需开启该功能，需先参照依赖项准备检查并确保所有服务器中已安装符合要求的 monit。开启时，守护进程将在服务器开机后自行启动并拉起 YashanDB 的各个进程，间接实现数据库的开机自启动。

• 用户添加到 YASDBA 用户组：开启表示将安装用户加入 YASDBA 组，可免密登录数据库。

• 上述功能开启后均需安装用户具备 sudo 权限，本示例使用默认配置，即仅开启将用户添加到 YASDBA 用户组。

Note:

1. 若【开机自启 monit】参数设置为关闭但后续需使用相关功能，可参考守护进程完成相关配置。

2.确认信息无误后，单击【下一步】。

步骤 4：配置数据库节点信息

1. 在弹出的节点规模配置对话框中，根据实际规划的节点数调整相关配置，单击【确定】保存信息。

• MN 节点数量：选择 MN 节点数量。

• CN 节点数量：选择 CN 节点数量。

• DN 节点组数量：选择 DN 节点组数量。

• DN 节点数量：选择 DN 节点数量。

• 起始端口：填写数据库监听端口的起始值，若存在多个监听端口系统会根据端口划分规则自行计算，默认值为 1688。

• 节点默认路径：填写 YashanDB 的数据目录，置空则默认使用服务器安装路径下的 DATA 目录，安装后修改不生效，例如/data/yashan/yasdb_data。

• 是否开启推荐配置：开启推荐配置时，yasom 将调用DBMS_PARAM高级包生成推荐参数覆盖同名配置参数，默认为开启。开启时，还需配置以下参数：YashanDB 内存占用：设置 YashanDB 可用服务器内存的百分比，yasom 将根据该百分比计算出具体内存限制。表类型：选择主要业务常用的表类型，修改数据库配置参数，在数据库使用该表类型时获取最大性能，默认为 LSC。

2.在 yasom 配置区域，可根据实际情况调整主 yasom 所在服务器和监听端口。

• yasom 所在主机：默认为当前服务器 IP。

• LISTEN_ADDR：yasom 的监听端口，默认为 1675。

3.在推荐配置区域，检查配置信息，此处配置取至节点规模中的对应配置。

开启推荐配置后，部分参数会有固定值，无法修改。参数如下：+--------------------------------+-------------+---------+|            name                |  recommend  | restart |+--------------------------------+-------------+---------+| DATA_BUFFER_SIZE               |       5498M |  True   || VM_BUFFER_SIZE                 |        741M |  True   || WORK_AREA_STACK_SIZE           |          1M |  True   || WORK_AREA_POOL_SIZE            |         16M |  True   || WORK_AREA_HEAP_SIZE            |       2048K |  True   || SHARE_POOL_SIZE                |        741M |  True   || LARGE_POOL_SIZE                |        112M |  True   || MAX_PARALLEL_WORKERS           |          12 |  True   || SCOL_DATA_BUFFER_SIZE          |        128M |  True   || SCOL_DATA_PRELOADERS           |           2 |  True   || COLUMNAR_WORK_AREA_HEAP_SIZE   |         32M |  True   || COLUMNAR_VM_BUFFER_SIZE        |        128M |  True   || COLUMNAR_BULK_SIZE             |        1024 |  True   || COMPRESSION                    |         LZ4 |  True   || PQ_POOL_SIZE                   |        128M |  True   || MAX_SESSIONS                   |         128 |  True   || MAX_WORKERS                    |           0 |  True   || TAB_QUEUE_WINDOW_SIZE          |           8 |  True   || BLOOM_FILTER_FACTOR            |         0.5 |  True   || DEGREE_OF_PARALLEL             |           1 |  True   || MMS_DATA_LOADERS               |           3 |  True   || CHECKPOINT_INTERVAL            |        192M |  False  || CHECKPOINT_TIMEOUT             |          60 |  False  || REDOFILE_IO_MODE               |      DIRECT |  True   || DATAFILE_IO_MODE               |     DEFAULT |  True   || COMMIT_LOGGING                 |   IMMEDIATE |  False  || RECOVERY_PARALLELISM           |           2 |  True   || REDO_BUFFER_SIZE               |         16M |  True   |+--------------------------------+-------------+---------+

4.在 yasagent 配置区域，可按需调整以下配置：

• yasagent LISTEN_ADDR：yasagent 的监听端口，默认为 1676。

• DB 自适应内存限制：仅当开启推荐配置时，必须配置内存限制，格式为数字 + 空/K/M/G/T，取值范围[节点数 * 1536M,服务器最大内存]。

• 包含节点：显示每个服务器上对应部署的节点信息，带星标的节点角色为主，其他为备。可拖拽节点调整节点分布。

5.在节点配置区域，展开节点列表，单击节点名称，可查看节点信息，并可按需调整部分配置。 

6.确认信息无误后，单击【下一步】。

步骤 5：设置建库参数

在【数据库建库参数】页面，可参考分布式配置文件按需增/删/改各节点组的参数，确认信息无误后，单击【下一步】。

步骤 6：设置配置参数

在【数据库节点参数】页面，可按需增/删/改各节点的参数，确认信息无误后，单击【保存并下一步】。

步骤 7：部署数据库

1. 在【数据库全局信息】页面，确认信息无误后，单击【部署】。

   
   

2.部署任务进度达到 100%时，表示部署完成，单击【退出部署程序】退出。 

若不手动退出，服务端也会在一定时间内自动退出。

Note:

部署完成后，yasom 会在/home/yashan/install/conf/SE/yashandb目录中生成 hosts.toml 和 yashandb.toml 文件，其中 yashandb 为数据库名称，此目录为安装目录。

步骤 8：配置环境变量

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

# 部署命令成功执行后将会在$YASDB_HOME目录下的conf文件夹中生成<<集群名称>>.bashrc环境变量文件$ cd /data/yashan/yasdb_home/yashandb/23.3.1.100/conf# 如~/.bashrc中已存在YashanDB相关的环境变量，将其清除
$ cat yashandb.bashrc >> ~/.bashrc$ source ~/.bashrc

Copied!

步骤 9：检查安装结果

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

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

$ yasboot cluster password set -n newpasswd -c yashandb

2.使用yasql工具连接数据库，查看实例状态。

$ yasql sys/password@192.168.1.3:1688SQL> SELECT STATUS FROM V$INSTANCE;
STATUS        ------------- OPEN        
SQL> SELECT database_name FROM v$database;
DATABASE_NAME                                                    ---------------------------------------------------------------- yashandb

3.（可选）创建数据库用户并赋权，更多操作请查阅用户管理。

SQL> CREATE USER sales IDENTIFIED BY sales;
SQL> GRANT CONNECT TO SALES;

步骤 10（可选）：开启仲裁选主

若 DN 节点数量配置为 2（即 DN 节点采用一主一备规格），需使用基于 yasom 的仲裁选主才能实现 DN 组内节点的主备自动切换。