search-icon search-icon

#单机（主备）部署

# 步骤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端浏览器中访问可视化安装的网页地址。

    home

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

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

    • 数据库名称：填写数据库集群名称，该名称也将作为初始数据库的名称（database name）。必须以字母开头，长度为[1,63]个字符，例如yashandb。
    • 数据库类型：选择数据库部署形态，例如单机。
    • 安装包路径：填写安装包所在路径，安装用户需有该路径的操作权限，例如/home/yashan/install/yashandb-23.2.1.100-linux-x86_64.tar.gz。
    • 插件包路径：选填参数，如需使用DBLINK功能和更丰富的内置函数（例如GIS Function、LSFA_LISTAGG），需先下载plugin插件包至服务器并填写插件包所在路径，安装用户需有该路径的操作权限，例如/home/yashan/install/yashandb-plugins-all-23.2.1.100-linux-x86_64.tar.gz。安装完成后，无法单独安装该插件包。

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

    se_base_info_01

  3. （可选）如需部署主备高可用环境，单击服务器列表上方的【添加】，增加其他服务器信息后单击【确定】保存配置，单击【全部尝试连接】检查连通性。

    • 主机地址：服务器的IP地址，格式：192.168.1.3或192.168.1.[3-4]，允许配置多个IP地址/集，使用换行符分割。
    • 用户名：安装用户的名称，例如yashan。
    • 密码：可选参数，安装用户的密码，若已配置当前服务器对其他服务器SSH免密，无需填写密码。
    • SSH端口：SSH端口，例如22。
    • 安装路径：数据库安装路径，即安装前划分的安装目录，例如/data/yashan/yasdb_home。

    base_info_02

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

# 步骤3：配置服务器sudo

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

    • 创建cgroup：开启表示创建用于YashanDB CPU资源管理的cgoup目录，并需填写服务器其他配置区域的cgroup目录。仅需安装可开启CPU资源管理的单机数据库（非级联备）时需配置该参数，具体请查阅配置资源管理。
    • 开机自启monit：如需开启该功能，需先参照依赖项准备检查并确保所有服务器中已安装符合要求的monit。开启时，守护进程将在服务器开机后自行启动并拉起YashanDB的各个进程，间接实现数据库的开机自启动。
    • 用户添加到YASDBA用户组：开启表示将安装用户加入YASDBA组，可免密登录数据库。

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

    Note:

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

    se_sudo

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

# 步骤4：配置集群节点信息

  1. 在节点规模区域，单击【编辑】。

    se_node_info_01

  2. 在弹出的对话框中，可根据实际情况调整相关配置，单击【确定】保存信息。

    • 单机节点数量：选择服务器上的数据库实例数量，默认为1，生产环境建议为1。
    • 起始端口：填写数据库监听端口的起始值，若存在多个监听端口系统会根据端口划分规则自行计算，默认值为1688。
    • 节点默认路径：填写YashanDB的数据目录，置空则默认使用服务器安装路径下的DATA目录，安装后修改不生效，例如/data/yashan/yasdb_data。
    • 是否开启推荐配置：开启推荐配置时，yasom将调用DBMS_PARAM高级包生成推荐参数覆盖同名配置参数，默认为开启。开启时，还需配置以下参数：
      • YashanDB内存占用：设置YashanDB可用服务器内存的百分比，yasom将根据该百分比计算出具体内存限制。
      • 表类型：选择主要业务常用的表类型，修改数据库配置参数，在数据库使用该表类型时获取最大性能，默认为HEAP。

    se_node_info_02

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

    • yasom所在主机：默认为当前服务器IP。
    • LISTEN_ADDR：yasom的监听端口，默认为1675。

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

    开启推荐配置后，部分参数会有固定值，无法修改。参数如下：
+--------------------------------+-------------+---------+
|            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   |
+--------------------------------+-------------+---------+

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

    • yasagent LISTEN_ADDR：yasagent的监听端口，默认为1676。
    • DB自适应内存限制：仅当开启推荐配置时，必须配置内存限制，格式为数字 + 空/K/M/G/T，取值范围[实例数 * 1536M,服务器最大内存]。
    • 包含节点：显示每个服务器上对应部署的数据库实例信息，带星标的实例角色为主，其他为备。存在多个服务器时，可拖拽实例调整其分布。

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

    se_node_info_next

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

# 步骤5：设置建库参数

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

se_create_param_next

# 步骤6：设置配置参数

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

se_node_param_next

# 步骤7：部署数据库

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

    se_global_info_next

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

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

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.1.100/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.2: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;
pdf-btn 下载文档
copy-btn 复制链接
段落导航
步骤1：启动Web服务
步骤2：配置数据库基本信息与服务器信息
步骤3：配置服务器sudo
步骤4：配置集群节点信息
步骤5：设置建库参数
步骤6：设置配置参数
步骤7：部署数据库
步骤8：配置环境变量
步骤9：检查安装结果