2.1 yasboot工具

yasboot是YashanDB配套的运维管理工具，用于在数据库集群环境中对YashanDB进行各种远程的运维管理操作，例如：

• 安装部署
• 离线升级
• 实例启停
• sys账号密码设置
• yasql工具集成
• IP更换

• yasboot进程
  通过yasboot安装YashanDB产品时，将启动yasom进程（全局1个）和yasagent进程（每台服务器1个），yasboot的运行均依赖于这两个进程。
• yasom进程
  YashanDB运维服务进程，接收yasboot命令并进行指令下发和控制，管理yasagent进程。
• yasagent
  无状态的运维服务进程，运行在YASDB进程所在的服务器上，接收yasom的指令并通过工具/驱动/命令等方式向YASDB进程或文件系统执行查询和操作等任务。

2.2 初始环境调整

在此仅列出一些注意点。具体操作请见官网文档。

• 确定1688端口不被占用

# netstat -anp|grep 1688

• 关闭防火墙（建议）
• 关闭交换分区（目的是为最大限度使用物理内存）
• 调整自动分配本地端口范围

# echo "net.ipv4.ip_local_por t_range = 32768 60999" >> /etc/sysctl.conf

• 调整进程的VMA上限
  该参数作用是限制一个进程可以拥有的VMA（虚拟内存区域）的数量，调整是为了让数据库进程充分使用主机资源

# echo "vm.max_map_count=2000000" >> /etc/sysctl.conf

• 调整资源限制值

# ulimit -n 65536 #设置可以打开的最大的文件描述符数量65536（单位:个）
# ulimit -u 65536 #设置可以打开的最大的进程数65536（单位:个）
# ulimit -m unlimited #设置没有限制的使用常驻内存的大小（单位:kbytes）
# ulimit -s 8192 #设置可以使用linux的默认栈空间大小是8192kb（单位:kbytes）

• 修改/etc/security/limits.conf

yashan sof t nofile 65536 #表示yashan用户可以打开的最大的文件描述符数量65536个
yashan hard nofile 65536
yashan sof t nproc 65536 #表示yashan用户可以打开的最大的进程数65536个
yashan hard nproc 65536
yashan sof t rss unlimited #表示yashan用户可以没有限制的使用常驻内存的大小
yashan hard rss unlimited
yashan sof t stack 8192 #表示yashan用户可以使用linux的默认栈空间大小是8192kb
yashan hard stack 8192

• 创建YashanDB用户、配置sudo权限
• 配置YASDBA用户组
• 目录规划
• 生成配置文件

$ ./bin/yasboot package se gen --cluster yashandb -u yashan -p yashan --ip 192.168.33.167 --por t 22 --install-path
/home/yashan/yasdb_home --data-path /home/yashan/yasdb_data --begin-port 1688

• 执行安装

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

此步骤会启动yasom和yasagent服务，为后面yasboot安装数据库做准备。

• 部署数据库

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

此步骤会启动yasdb服务，数据库部署成功。

• 配置环境变量
• 初始化sys用户密码

$ yasboot cluster password set -n yasdb_123 -c yashandb

• 卸载数据库

$ yasboot cluster clean --cluster yashandb --purge

• 卸载yasom和yasagent

$ yasboot package uninstall --cluster yashandb

2.3 yasql基本使用

• 通过输入用户名 、密码、数据库服务器名和监听端口等信息登录并连接数据库

$ yasql sys/yasdb_123@192.168.33.167:1688

如果省略ip和port，默认是连接到本地的1688端口。
用户名或者密码包含特殊符号，需要双引号包裹，并通过\对双引号进行转义或外加单引号进行包裹

• 通过操作系统认证方式登录

$ yasql / as sysdba

• 查看帮助和版本信息

$ yasql -H
$ yasql -V

• 执行SQL文件

$ yasql / as sysdba
SQL> @/home/yashan/a.sql

或

$ yasql / as sysdba -f a.sql

• 其他功能
  COLUMN 指定目标列的显示属性

SQL> col col1 for a8;

目前仅支持对字符列使用COLUMN命令。若对数值列使用COLUMN命令，该列将会显示“#”字符串。

通过 "!" 执行外部的shell 命令

$ yasql / as sysdba
SQL> ! ls -l /home/yashan

2.4 DBeaver连接配置YashanDB

推荐使用YashanDB官方下载的DBeaver，在严格遵循DBeaver Community Edition 的ASL开源协议基础上，进行了二次开发和封装。
JDK版本需要 17及以上版本。下载地址：

https://www.oracle.com/java/technologies/downloads