步骤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.2.0.2-linux-x86_64.tar.gz。
   • 插件包路径：选填参数，如需使用DBLINK功能和更丰富的内置函数（例如LSFA_LISTAGG函数），需先下载plugin插件包至服务器并填写插件包所在路径，安装用户需有该路径的操作权限，例如/home/yashan/install/yashandb-plugins-all-23.2.0.2-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:

   若【开机自启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.2.0.2/conf
# 如~/.bashrc中已存在YashanDB相关的环境变量，将其清除

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

步骤9：检查安装结果

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

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

   $ yasboot cluster password set -n newpasswd -c yashandb
   

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

   $ yasql sys/password@192.168.1.3:1688
   SQL> 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组内节点的主备自动切换。